মূল কনটেন্টে যান
লাইভ ডেমো
ব্লগ

হোটেল প্রাপ্যতা API: ধীর সাপ্লায়ারের জন্য ডিজাইন

Tekravel সম্পাদকীয়
AI-এর সহায়তায় লেখা

টিকিটটা সাধারণত নিরীহ দেখায়। "বুকিং পেজে হোটেল সার্চ যোগ করো — সাপ্লায়ার একটা হোটেল প্রাপ্যতা API দিয়েছে, sandbox আছে, এক স্প্রিন্টের কাজ।" আপনি ডকুমেন্টেশন পড়েন, কক্সবাজারে দুজন প্রাপ্তবয়স্কের তিন রাতের জন্য একটা অনুরোধ পাঠান, আর উত্তর ফিরে আসে। তারপর একই অনুরোধ পাঠান এমন শহরে যেখানে হোটেল অনেক বেশি, আর দীর্ঘ, অস্বস্তিকর সময় ধরে কিছুই ফেরে না। যখন ফেরে, তখন সেটা এত বড় একটা ডকুমেন্ট যে আপনার JSON parser নিজের জীবনের সিদ্ধান্ত নিয়ে ভাবতে বসে।

ঠিক ওই মুহূর্তে কাজের চেহারা বদলে যায়। হোটেলের প্রাপ্যতা কোনো lookup নয়। এটা একটা fan-out: আপনার ব্যবহারকারীর একটি প্রশ্ন অনেক সাপ্লায়ারের কাছে অনেক প্রশ্নে পরিণত হয়, আর প্রত্যেকে উত্তর দেয় নিজের গতিতে, নিজের শব্দভান্ডারে, "রুম" মানে কী সে বিষয়ে নিজের ধারণা নিয়ে। আপনি যে ক্লায়েন্ট বানাবেন, সেই fan-out শেষ না হওয়া পর্যন্ত পুরো সময়টা তাকে কাজের থাকতে হবে। এই লেখা সেই ক্লায়েন্ট ডিজাইন নিয়ে — এমন ডেভেলপারের জন্য, যিনি REST আর JSON ভালো জানেন, কিন্তু কখনো কোনো হোটেলকে ব্যাখ্যা করতে হয়নি কেন অতিথির নন-রিফান্ডেবল রেট "ফ্রি বাতিল" হিসেবে দেখানো হয়েছিল।

কেন হোটেল প্রাপ্যতা API আপনার চেনা endpoint-গুলোর চেয়ে ধীর

বাইরে থেকে ফ্লাইট সার্চ আর হোটেল সার্চ একই রকম দেখায়: একটা কোয়েরি যায়, দামসহ বিকল্প ফেরে। ভেতরে সমস্যাটা এক নয়। আমাদের ফ্লাইট বুকিং API ইন্টিগ্রেশনে আসলে কী লাগে লেখাটি পড়ে থাকলে জানেন, যে দাম সার্চ করেন সেটাই সবসময় বুক করা দাম নয়। হোটেল তার ওপর দ্বিতীয় একটা জটিলতা যোগ করে: পরিমাণ।

একটি শহরে শত শত হোটেল থাকতে পারে। প্রতিটি হোটেল কয়েক ধরনের রুম বিক্রি করে। প্রতিটি রুম টাইপ কয়েকটি rate plan-এ বিক্রি হয় — নাশতাসহ, নাশতা ছাড়া, রিফান্ডেবল, নন-রিফান্ডেবল, মেম্বার রেট, প্যাকেজ রেট। আর প্রতিটি rate plan আসতে পারে একাধিক উৎস থেকে: একটি bedbank, একটি channel manager, সরাসরি চুক্তি, কিংবা এমন কোনো হোলসেলার যার সঙ্গে চুক্তি করেছিলেন কারণ একটি নির্দিষ্ট হোটেলে তার allotment সবার চেয়ে ভালো ছিল। এগুলো গুণ করলে একটা "সাধারণ" সার্চ আসলে বিশাল একটা গাছ, কয়েকটি উৎস থেকে জোড়া লাগানো, যারা নাম বা ID কোনোটাতেই একমত নয়।

তাই ধীর অংশটা খুব কমই আপনার কোড। ধীর অংশটা হলো সেই সবচেয়ে ধীর সাপ্লায়ার, যার জন্য অপেক্ষা করবেন বলে আপনি ঠিক করেছেন।

ধাপে ধাপে ফলাফল নাকি পূর্ণ উত্তর: ভেবেচিন্তে বেছে নিন

হোটেল সার্চের ফলাফল ফেরানোর দুটো সৎ উপায় আছে, আর বেশিরভাগ ইন্টিগ্রেশন শেষ হয় এ দুইয়ের মাঝামাঝি কোনো অসুখী জায়গায়।

সবার জন্য অপেক্ষা করুন। আপনার backend অনুরোধ ছড়িয়ে দেয়, প্রতিটি সাপ্লায়ারের উত্তর বা timeout-এর জন্য অপেক্ষা করে, মেলায়, ডুপ্লিকেট সরায়, সাজায়, তারপর একটা সম্পূর্ণ তালিকা ফেরত দেয়। ফলাফল পরিষ্কার: একটা অনুরোধ, একটা উত্তর, আর দামগুলো তুলনা করা যায় কারণ সবই টেবিলে আছে। খরচটা হলো, প্রতিবার আপনার সবচেয়ে ধীর সাপ্লায়ার যতক্ষণ নেয়, ব্যবহারকারী ততক্ষণ spinner-এর দিকে তাকিয়ে থাকে।

যা আছে পাঠিয়ে দিন। backend fan-out শুরু করে আর সঙ্গে সঙ্গে একটা search handle ফেরত দেয়। ক্লায়েন্ট সেই handle poll করে, অথবা একটা stream খোলা রাখে, আর সাপ্লায়াররা উত্তর দেওয়ার সঙ্গে সঙ্গে ব্যাচে ব্যাচে ফলাফল পায়। প্রথম হোটেলগুলো দ্রুত দেখা দেয়। খরচটা হলো বাকি সব জায়গায় জটিলতা: ব্যবহারকারী পড়তে পড়তেই তালিকার ক্রম বদলায়, "সবচেয়ে সস্তা" ব্যাজ সরে যেতে পারে, আর এক সাপ্লায়ার থেকে আসা হোটেল পরে অন্য সাপ্লায়ার থেকে আরও সস্তা রেট পেতে পারে।

আপনার ইন্টারফেস যদি একজন মানুষের সামনে একটা সার্চ পেজ হয়, তবে ধাপে ধাপে ফলাফলই প্রায় সবসময় ঠিক — মানুষটি ব্রাউজ করছেন, batch job চালাচ্ছেন না, আর যে পেজ দৃশ্যত কাজ করছে সেটা নীরবে ভাবতে থাকা পেজের চেয়ে ভালো। আপনার গ্রাহক যদি আরেকটি মেশিন হয় — রেট তুলনার job, কিংবা কর্পোরেট বুকিং টুল যার একটা চূড়ান্ত উত্তর দরকার — তবে অপেক্ষা করাই প্রায়ই সহজ এবং সঠিক।

যেটাই বেছে নিন, তিনটি নিয়ম ধাপে ধাপে চলা ক্লায়েন্টকে সুস্থ রাখে:

  • প্রতিটি ব্যাচ পুরো সার্চের একটা সম্পূর্ণতার অবস্থা বহন করে, যাতে ক্লায়েন্ট "এখনো আর ফল নেই" আর "আর কখনো ফল আসবে না"-এর পার্থক্য বোঝে।
  • ফলাফল সার্ভারে একটি স্থির হোটেল কী দিয়ে মেলানো হয়, শুধু শেষে জুড়ে দেওয়া হয় না। দুটো কার্ড যে একই ভবন, সেটা ক্লায়েন্টকে কখনো নিজে বের করতে হবে না।
  • দাম অনুযায়ী সাজানো সার্চ শেষ না হওয়া পর্যন্ত অস্থায়ী, আর ইন্টারফেস সেটা বলে দেয়। ব্যবহারকারী ধীরে থিতু হওয়া তালিকা ক্ষমা করেন; ভুল প্রমাণিত "সর্বনিম্ন দাম" লেবেল ক্ষমা করেন না।

রুম আর rate plan এমনভাবে মডেল করুন যাতে ভেঙে না পড়ে

এখানেই বেশিরভাগ হোটেল ইন্টিগ্রেশন নীরবে ব্যর্থ হয়, আর সেই ব্যর্থতা মাস কয়েক পরে আসে সাপোর্ট টিকিট হয়ে, বাগ রিপোর্ট হয়ে নয়।

লোভনীয় মডেলটা সমতল: হোটেলের অফারের একটা তালিকা, প্রতিটি অফারে একটা রুমের নাম আর একটা দাম। দেখতে সুন্দর লাগে। তারপর এক সাপ্লায়ার স্পষ্টতই একই রুমের জন্য "Deluxe King" আর "Deluxe Room, 1 King Bed" ফেরত দেয়, আরেকজন সত্যিই আলাদা দুটো রুমের জন্য একই নাম পাঠায় (একটা শহরমুখী, একটা নয়), আর তৃতীয়জন প্রতি রাতের দাম দেয় যখন বাকিরা পুরো থাকার দাম দিচ্ছে। সমতল তালিকা বলতে পারে না আপনি কোনটা দেখছেন। সে শুধু দেখায়।

আসল সাপ্লায়ারের মুখোমুখি টিকে থাকা মডেলে অন্তত চারটি স্তর থাকে, আর সেগুলো আলাদা রাখা হয়:

স্তরকী রাখেযে ভুল এড়াতে হবে
হোটেলআপনার নিজের স্থির ID, প্রতিটি সাপ্লায়ারের কোডের সঙ্গে ম্যাপ করাসাপ্লায়ারের হোটেল ID-কে primary key বানানো
রুমঅতিথি সংখ্যা, বিছানার বিন্যাস, সাপ্লায়ারের মূল রুম-বিবরণ হুবহুরুমের নাম "পরিষ্কার" করতে করতে দুটো আলাদা রুম এক হয়ে যাওয়া
Rate planBoard basis, রিফান্ডযোগ্যতা, পেমেন্টের ধরন, কোন সাপ্লায়ার থেকে এসেছেনাশতা বা রিফান্ডযোগ্যতাকে রুমের নামের অংশ ধরা
দামপুরো থাকার মোট, মুদ্রা, কোন ট্যাক্স ও ফি ভেতরে আছে আর কোনগুলো হোটেলে দিতে হবেপুরো থাকার দামের পাশে প্রতি রাতের দাম দেখানো, বা পৌঁছানোর সময় দেয় ফি লুকানো

রেখাগুলো কোথায় টানা হবে তা নিয়ে আপনি দ্বিমত করতে পারেন — কিছু টিম অতিথি সংখ্যাকে আলাদা স্তর বানায়, যা একাধিক রুমের বুকিং বিক্রি শুরু করলে যুক্তিসঙ্গত। যা পারবেন না তা হলো স্তরগুলো মিশিয়ে ফেলা, শুধু এই কারণে যে ইন্টারফেস তাদের দুটো দেখায়। ইন্টারফেস রেন্ডারের সময় সমতল করতে পারে। ডেটা পারে না।

একটা খুঁটিনাটি নিজের একটা বাক্য পাওয়ার যোগ্য: যা-ই normalise করুন, তার পাশে সাপ্লায়ারের কাঁচা রুম-বিবরণ রেখে দিন। যখন কোনো অতিথি পৌঁছে ভাউচারের চেয়ে আলাদা রুম পান, সবার প্রথম প্রশ্ন হয়: সাপ্লায়ার আসলে কী পাঠিয়েছিল।

বাতিল নীতি হলো ডেটা, অনুচ্ছেদ নয়

অনেক সাপ্লায়ার বাতিলের শর্ত মুক্ত টেক্সট হিসেবে ফেরত দেয়: "পৌঁছানোর ৩ দিন আগে পর্যন্ত ফ্রি বাতিল, তারপর ১ রাতের জরিমানা।" ওই স্ট্রিংটা দেখিয়ে দিয়ে পরের কাজে চলে যাওয়ার লোভ খুব বেশি।

করবেন না। টেক্সট তুলনা, সাজানো, ফিল্টার বা প্রয়োগ করা যায় না। আপনার ব্যবহারকারী শুধু রিফান্ডেবল রেট দেখতে চান। আপনার ফাইন্যান্স টিম জানতে চায় কোন বুকিংগুলো কাল থেকে নন-রিফান্ডেবল হয়ে যাবে, যাতে সময়সীমা পেরোনোর আগে এজেন্সি ক্লায়েন্টের সঙ্গে যোগাযোগ করতে পারে। বুকিং-পরবর্তী ফ্লো-কে গ্রাহক যখন বাতিল বোতাম চাপেন ঠিক তখন বলতে হবে তাঁর কাছ থেকে ঠিক কত কাটা হবে। এর কোনোটাই একটা বাক্যের ওপর চলে না।

প্রতিটি নীতিকে জরিমানা-জানালার একটা ক্রমিক তালিকা হিসেবে মডেল করুন: এই মুহূর্ত থেকে ওই মুহূর্ত পর্যন্ত চার্জ এই অঙ্ক (অথবা থাকার এই অংশ, অথবা এতগুলো রাত)। সীমাগুলো timezone-সহ timestamp — হোটেলের timezone, আপনার সার্ভারের নয়, ব্যবহারকারীরও নয় — কারণ "পৌঁছানোর ৩ দিন আগে" মানে ভিন্ন মুহূর্ত, নির্ভর করে আপনি কার মধ্যরাত গুনছেন। সাপ্লায়ারের মূল টেক্সট কাঠামোবদ্ধ সংস্করণের পাশে রাখুন, কাঠামোবদ্ধটাই দেখান, আর দুটোর অমিলকে তদন্তের বিষয় হিসেবে দেখুন, লুকানোর নয়।

আর বুকিংয়ের সময় নীতিটা আবার যাচাই করুন, শুধু সার্চের সময় নয়। এই দুই কলের মাঝে নীতি যে কারও প্রত্যাশার চেয়ে বেশি বদলায়।

ভুল করলে আসলে কত খরচ

ধীর সার্চে কনভার্সন হারায় — খারাপ, কিন্তু চোখে পড়ে; কেউ না কেউ অভিযোগ করবে। দামি ব্যর্থতাগুলো হলো নীরবগুলো।

যে রেট রিফান্ডেবল দেখানো হয়েছে কিন্তু সাপ্লায়ার নন-রিফান্ডেবল ধরে, সেটা স্ক্রিনশট হাতে থাকা গ্রাহকের সঙ্গে বিরোধ, আর জরিমানা সাধারণত এজেন্সিকেই দিতে হয়। প্রতি রাতের দাম যদি পুরো থাকার মোট হিসেবে দেখানো হয়, হিসাব বিভাগের কেউ খেয়াল না করা পর্যন্ত রুম খরচের নিচে বিক্রি হতে থাকে। অন্য রুমের সঙ্গে মিশে যাওয়া রুম চারজনের পরিবারকে দুজনের রুমে পাঠায়। হোটেলে দেয় যে ফি কখনো দেখানো হয়নি, তা পাঁচ-তারকা রিভিউকে chargeback-এ বদলে দেয়। প্রতিটিই প্রথম স্প্রিন্টে নেওয়া মডেলিং সিদ্ধান্ত, সাধারণত "পরে গুছিয়ে নেব" লেবেলে।

Cache: কী রাখা যায় আর কী একেবারেই নয়

হোটেল API যুক্ত করা প্রতিটি টিম একসময় জিজ্ঞেস করে, সার্চ দ্রুত আর সস্তা করতে ফলাফল cache করা যায় কি না। উত্তর হ্যাঁ, কিছু জিনিসের জন্য, আর তাদের মধ্যকার রেখাটা যেকোনো পারফরম্যান্স সংখ্যার চেয়ে গুরুত্বপূর্ণ।

স্থির কনটেন্ট — হোটেলের নাম, ঠিকানা, স্থানাঙ্ক, ছবি, সুবিধার তালিকা, রুমের বিবরণ — কদাচিৎ বদলায়, আর ঠিক এগুলোই নিজের স্টোরে জোর দিয়ে cache করা উচিত। কীভাবে সংরক্ষণ ও প্রদর্শন করা যাবে সে বিষয়ে সাপ্লায়ারের শর্ত দেখে নিন; কিছু লাইসেন্স তা সীমিত করে। প্রতিটি সার্চে লাইভ আনা অকারণে ধীর।

লাইভ রেট আর প্রাপ্যতা আলাদা ব্যাপার। cache করা দাম হলো সাপ্লায়ার কত নেবে তার একটা অনুমান, আর সাপ্লায়াররা আপনার অনুমানকে সম্মান করে না। পেজ দেখানোর জন্য সার্চ ফলাফলের স্বল্পমেয়াদি cache গ্রহণযোগ্য হতে পারে — যদি প্রতিটি বুকিং পথ টাকা নেওয়ার আগে সাপ্লায়ারের কাছে আবার দাম যাচাই করে, আর ইন্টারফেস বদলে যাওয়া দামকে স্বাভাবিক ফল হিসেবে দেখে, ত্রুটি হিসেবে নয়। কিছু সাপ্লায়ার সার্চ আর বুকিংয়ের অনুপাতও সীমিত করে; যে আক্রমণাত্মক cache আপনার আসল ট্রাফিক তাদের কাছ থেকে লুকায়, তা ভরসা করার মতো ফাঁক নয়।

যা কখনো cache করা যাবে না, তা হলো এমন যেকোনো কিছু যা একটা প্রতিশ্রুতি বোঝায়: ধরে রাখা দামের token, বুকিং রেফারেন্স, বাতিলের জরিমানার উদ্ধৃতি। এগুলো একজন ব্যবহারকারী আর একটা মুহূর্তের।

"শেষ" বলার আগে

আসল বুকিং বহন করার আগে নিজের ইন্টিগ্রেশনে চালিয়ে দেখার মতো একটা ছোট যাচাই:

  • সার্চ একটা সম্পূর্ণতার অবস্থা ফেরত দেয়, আর তার আগে-পরে ক্লায়েন্টের আচরণ আলাদা।
  • হোটেলগুলোর কী আপনার নিজের ID, যার সঙ্গে প্রতিটি সাপ্লায়ারের কোড ম্যাপ করা।
  • রুম, rate plan আর দাম আপনার ডেটায় আলাদা অবজেক্ট, স্ক্রিন যা-ই দেখাক।
  • প্রতিটি দাম বলে সেটা প্রতি রাতের নাকি পুরো থাকার, আর পৌঁছানোর সময় কী দিতে হবে।
  • বাতিল নীতি হোটেলের timezone-এ সময়বদ্ধ জরিমানা-জানালা হিসেবে রাখা, সঙ্গে মূল টেক্সটও।
  • কারও কাছ থেকে টাকা নেওয়ার আগে বুকিং পথ আবার দাম যাচাই করে আর নীতি আবার পড়ে।
  • প্রতিশ্রুতি বোঝায় এমন কিছুই কখনো cache থেকে দেওয়া হয় না।

এসব প্রতিটি সাপ্লায়ারের সঙ্গে আলাদা করে বানাবেন, নাকি এমন প্ল্যাটফর্ম থেকে শুরু করবেন যা আগেই এই সমস্যাগুলোর মুখোমুখি হয়েছে — তা যদি ভাবেন, তবে চুক্তির দিকটা কোডের মতোই গুরুত্বপূর্ণ। হোটেল কনসলিডেটর চুক্তি আর bedbank রেট নিয়ে আমাদের লেখায় আছে কী চাইতে হবে। আমাদের ফ্লাইট ও হোটেল API খোলা হয় আলোচনার মাধ্যমে, self-serve key দিয়ে নয়; এটাই যদি আপনার পছন্দের পথ হয়, travel APIs পেজে আলোচনা শুরু করুন।

fan-out কখনো চলে যায় না। ভালো ক্লায়েন্ট শুধু ভান করা বন্ধ করে যে এটা নেই।

Tekravel সম্পাদকীয়

ট্রাভেল টেকনোলজি ডেস্ক

Tekravel-এর ট্রাভেল টেকনোলজি ডেস্ক লেখে ইন্ডাস্ট্রির জন্য: এজেন্সি মালিক, কনসলিডেটর এবং যেসব ডেভেলপার তাঁদের সংযুক্ত করেন। প্রতিটি লেখা প্রকাশের আগে সেই প্ল্যাটফর্মেই যাচাই করা হয় যেটির কথা সেখানে বলা হয়েছে।