ফ্লাইট বুকিং API ইন্টিগ্রেশন: ডকুমেন্টেশনে যা লেখা থাকে না

বোর্ডের টিকিটে লেখা "ফ্লাইট যোগ করো"। আপনি আগে পেমেন্ট গেটওয়ে জুড়েছেন, ডেলিভারি চার্জের হিসাব জুড়েছেন, হয়তো ম্যাপও, আর মাথায় যে মডেলটা নিয়ে আসছেন সেটা সবচেয়ে সোজা: সার্চ করো, ফলাফল দেখাও, কার্ড থেকে টাকা কাটো, শেষ। তারপর প্রথম আসল বুকিংটা ফলাফলের পাতার চেয়ে ভিন্ন দামে ফিরে আসে, দ্বিতীয়টা টাইমআউট হয় আর কেউ বলতে পারে না গ্রাহকের সিট আছে কি না, আর অপারেশনস থেকে কেউ জানতে চায় রিজার্ভেশন আছে অথচ টিকিট নেই কেন। ফ্লাইট বুকিং API ইন্টিগ্রেশন বাইরে থেকে ই-কমার্স চেকআউটের মতো দেখায়। ভেতরে এটি এমন সব সিস্টেমের সঙ্গে একটি বিতরিত লেনদেন, যেগুলো REST-এর অনেক আগে নকশা করা, আর বেশিরভাগ চমক আসে ঠিক এই ফাঁক থেকে।
লেখাটি সেই ডেভেলপারের জন্য, যিনি কখনো PNR দেখেননি। এটি কোনো নির্দিষ্ট সরবরাহকারীর এন্ডপয়েন্ট নিয়ে নয়; নাম প্রদানকারী ভেদে বদলায়, কাঠামো বদলায় না।
ফ্লাইট বুকিং API ইন্টিগ্রেশনের কলের ক্রম
প্রায় প্রতিটি ফ্লাইট API, মেথডের নাম যা-ই হোক, একই চারটি ধাপ পার হয়। ধাপগুলোর সীমানা ঠিকভাবে টানাই কাজের বড় অংশ।
| ধাপ | যা পান | যা সংরক্ষণ করতে হবে | যেখানে ভুল হয় |
|---|---|---|---|
| সার্চ | দামসহ যাত্রাপথ আর একটি অস্বচ্ছ অফার বা ফেয়ার কী | স্থায়ী কিছু নয় — ফলাফল দ্রুত বাসি হয় | দামকে চূড়ান্ত ধরা; চেকআউটের আগেই কী মেয়াদোত্তীর্ণ |
| দাম যাচাই | নিশ্চিত দাম, ভাড়ার নিয়ম, ব্যাগেজ, কখনো যাত্রীর বাধ্যতামূলক তথ্য | যাচাই করা অফার ও তার মেয়াদ | দাম বদলেছে; ক্লাস বিক্রি শেষ; দেখানো নিয়মের সঙ্গে মেলে না |
| বুক | একটি রিজার্ভেশন — PNR — সঙ্গে বুকিং কোড ও টিকিট ইস্যুর সময়সীমা | আপনার নিজস্ব রেফারেন্স, বুকিং কোড, সময়সীমা, ঠিক যে যাত্রীতথ্য পাঠানো হয়েছে | উত্তরহীন টাইমআউট; ডুপ্লিকেট PNR; নাম প্রত্যাখ্যাত |
| টিকিট ইস্যু | ইস্যু হওয়া ই-টিকিট নম্বর; এখানেই আসলে টাকা দায়বদ্ধ হয় | প্রতিটি টিকিট নম্বর, সংশ্লিষ্ট যাত্রী ও সেগমেন্টের সঙ্গে | আংশিক ইস্যু; সময়সীমা পেরোনোয় এয়ারলাইন রিজার্ভেশন বাতিল করেছে |
লোকে সবচেয়ে বেশি তর্ক করে তৃতীয় সারি নিয়ে, কারণ অনেক API একটি কলেই বুক আর টিকিট দুটোই করতে দেয়। চাইলে ব্যবহার করুন। তবু এয়ারলাইনের জগতে দুটো আলাদা: টিকিট ছাড়াও PNR থাকতে পারে, আর PNR তৈরি হওয়ার পরও টিকিট ইস্যু ব্যর্থ হতে পারে। সম্মিলিত এন্ডপয়েন্ট শুধু সেই মুহূর্তটা লুকিয়ে রাখে যখন একটি সফল আর অন্যটি নয়, তাই আপনার ডেটা মডেলে ওই অবস্থার জায়গা রাখতেই হবে।
এটাও খেয়াল করুন সার্চ কী ফেরত দেয় না: প্রতিশ্রুতি। সার্চের ফলাফল একটা বিজ্ঞাপন। দাম যাচাই হলো কোটেশন, আর বিক্রি কেবল টিকিট।
সার্চের দাম কেন বুকিংয়ের দাম নয়
ওয়েব ডেভেলপার একটি ক্যাটালগ আশা করেন। এয়ারলাইনের ইনভেন্টরি ক্যাটালগ নয়। একটি ফ্লাইট বুকিং ক্লাসে বিক্রি হয়, প্রতিটি ক্লাস এক ভাড়ায় কিছু সিটের একটি বালতি, আর বিমান যত ভরে এয়ারলাইন তত এই বালতিগুলো খোলে-বন্ধ করে। সার্চের ফলাফল দ্রুত জোড়া লাগানো হয় এমন প্রাপ্যতা থেকে, যা হয়তো ইতিমধ্যে একটু পিছিয়ে; ব্যবহারকারী দুটি পাসপোর্টের তথ্য টাইপ করতে করতে ওই ফ্লাইটের সবচেয়ে সস্তা ক্লাস বন্ধ হয়ে যেতে পারে। দাম যাচাই আবার জিজ্ঞেস করে, আর সৎ উত্তরটা কখনো বেশি হয়।
ট্যাক্স নিজের মতো সরে। দাম যাচাইয়ের সময় সঠিক যাত্রী ও রুটের জন্য ট্যাক্স নতুন করে হিসাব হয়, আর শিশু বা ইনফ্যান্টের দাম সার্চ যে প্রাপ্তবয়স্ক ধরে নিয়েছিল তার থেকে আলাদা। আপনার স্টোর যদি টাকায় দেখায় অথচ সরবরাহকারী অন্য মুদ্রায় দর দেয়, তবে মুদ্রা রূপান্তর আরেকটি জায়গা যেখানে সংখ্যা নড়ে।
নকশার সিদ্ধান্তটা সহজ এবং প্রায়ই বাদ পড়ে: সার্চের দামে কখনো টাকা কাটবেন না। পেমেন্টের আগে দাম যাচাই চালান, তুলনা করুন, আর অঙ্ক বদলালে নতুন সংখ্যাটা দেখিয়ে সম্মতি নিন। যে মার্কআপই যোগ করুন, ফলাফলের পাতা থেকে বয়ে না এনে নতুন দামের ওপর আবার হিসাব করতে হবে — যুক্তিটা ঠিক সেটাই, যা একটি এজেন্সি অনলাইনে মার্কআপ কৌশল ঠিক করার সময় ভাবে, আর নিচের ভিত্তি সরে গেলে এটা একইভাবে ভেঙে পড়ে।
Idempotency, এবং বুকিংয়ের সময় টাইমআউটের মানে
এই অংশটা দুবার পড়ুন।
বুকিং কল টাইমআউট হলে আপনি জানেন না কী ঘটেছে। অনুরোধ হয়তো পৌঁছায়ইনি। হয়তো পৌঁছে ব্যর্থ হয়েছে। অথবা — যেটা সবচেয়ে কষ্টের — পৌঁছেছে, সরবরাহকারী এয়ারলাইনে PNR তৈরি করেছে, আর উত্তরটা ফেরার পথে হারিয়ে গেছে। আপনার কোডের কাছে তিনটিই একরকম। এয়ারলাইনের কাছে তৃতীয়টি একটি জীবন্ত রিজার্ভেশন, যা আপনার গ্রাহকের নামে সিট ধরে রেখেছে।
অন্য ইন্টিগ্রেশন থেকে শেখা অভ্যাস হলো আবার চেষ্টা করা। এখানে অন্ধভাবে আবার চেষ্টা করলে একই যাত্রীর জন্য একই ফ্লাইটে দ্বিতীয় PNR তৈরি হতে পারে। এয়ারলাইনগুলো ডুপ্লিকেট বুকিংকে নীতিভঙ্গ হিসেবে দেখে; এয়ারলাইন ও এজেন্সির চুক্তি অনুযায়ী পরিণতি হতে পারে একটি বা দুটি রিজার্ভেশনের স্বয়ংক্রিয় বাতিল থেকে শুরু করে যে ইস্যু করেছে তার কাছে পাঠানো একটি ডেবিট মেমো — ADM — পর্যন্ত। যে এজেন্সি সেটা পাবে, তারা জানতে চাইবে আপনার সিস্টেম কেন দুবার বুক করল।
যা কাজ করে, মোটামুটি এই ক্রমে:
- বাইরে কল করার আগেই নিজের বুকিং রেফারেন্স তৈরি করুন, সংরক্ষণ করুন, আর যেখানে API ক্লায়েন্ট রেফারেন্স নেয় সেখানে অনুরোধের সঙ্গে পাঠান। API যদি idempotency key সমর্থন করে, ব্যবহার করুন; না করলেও আপনার রেফারেন্সই পরে বুকিং খুঁজে পাওয়ার উপায়।
- অজানা অবস্থাকে স্পষ্টভাবে মডেল করুন। অপেক্ষমাণ, নিশ্চিত, ব্যর্থ — আর অজানা। টাইমআউট বুকিংকে অজানায় নেয়, ব্যর্থে নয়।
- অজানা অবস্থা মেটান জিজ্ঞেস করে, পুনরাবৃত্তি করে নয়। আবার চেষ্টার সিদ্ধান্তের আগে আপনার রেফারেন্স দিয়ে বুকিং খুঁজুন, বা ওই যাত্রীদের সাম্প্রতিক বুকিংয়ের তালিকা দেখুন।
- একটি রিকনসিলিয়েশন জব চালান, যা অজানা থেকে যাওয়া সবকিছু ঝাড়ু দিয়ে সরবরাহকারীর রিপোর্টের সঙ্গে মেলায়, আর যা মেটাতে পারে না তা অনুমান না করে মানুষের সারিতে পাঠায়।
টিকিট ইস্যুর টাইমআউট একই সমস্যা, শুধু টাকা জড়িত। টিকিটের আগে কার্ড থেকে টাকা কাটলেন আর ইস্যু আটকে গেল — আপনার হাতে টাকা দেওয়া গ্রাহক, হয়তো টিকিট ছাড়াই। টাকা কাটার আগে টিকিট ইস্যু করলেন আর টাকা কাটা ব্যর্থ হলো — আপনি এমন একটি নথি ইস্যু করেছেন যার দাম কাউকে এয়ারলাইনকে দিতে হবে। প্রচলিত ধরন হলো আগে কার্ড অথরাইজ, তারপর টিকিট, সফল হলে ক্যাপচার — মূল কথা হলো সিদ্ধান্তটা সচেতনভাবে নেওয়া, প্রোডাকশনে আবিষ্কার না করা।
এয়ারলাইনের যে ধারণাগুলো ওয়েব ডেভেলপারদের চমকে দেয়
কোনোটিই কঠিন নয়। প্রতিটিই কারো না কারো এক সপ্তাহ খেয়েছে, কারণ তিনি জানতেন না এটা আছে।
PNR টিকিট নয়
PNR হলো রিজার্ভেশনের রেকর্ড: যাত্রী, সেগমেন্ট, যোগাযোগ, সময়সীমা। টিকিট হলো মূল্য পরিশোধিত নথি, যা যাত্রীকে উড়ার অধিকার দেয়। টিকিটবিহীন PNR তার সময়সীমায় মেয়াদোত্তীর্ণ হয় আর সিট আবার বিক্রিতে ফেরে, কখনো আপনার দিক থেকে নিঃশব্দে।
নাম প্রায় বদলানো যায় না
টিকিট ইস্যুর পর বেশিরভাগ ভাড়ায় ছোটখাটো সংশোধনের বাইরে নাম বদলানো যায় না, আর কোনটা ছোটখাটো তা এয়ারলাইন ভেদে আলাদা। নাম ভ্রমণ নথির সঙ্গে মিলতে হবে। পদবি আর নাম আলাদা করে নিন — একক নামের ক্ষেত্রে সরবরাহকারীর নিয়ম আগে দেখে নিন — ফ্রি-টেক্সট থেকে কোনো সম্বোধন যেন নামের ঘরে না ঢোকে, আর যাচাই করুন বুক কলের আগে, পরে নয়।
যাত্রীর ধরন সাজসজ্জা নয়, দাম
প্রাপ্তবয়স্ক, শিশু ও ইনফ্যান্ট হলো ভাড়ার ধরন, আর কোনটা প্রযোজ্য তা ঠিক করে সাধারণত ভ্রমণের দিনের বয়স, বুকিংয়ের দিনের নয়। কোলে বসা ইনফ্যান্ট সাধারণত সিট নেয় না এবং কেবল প্রাপ্তবয়স্কের সঙ্গে যেতে পারে। ধরন ভুল হলে দাম যাচাই হয় ব্যর্থ হয়, নয়তো ভুল ভাড়া দেখায়।
সময় স্থানীয়, আর সেগমেন্ট মানে লেগ নয়
প্রস্থান ও আগমনের সময় দেওয়া থাকে প্রতিটি বিমানবন্দরের স্থানীয় সময়ে। দেখানোর জন্য ব্যবহারকারীর টাইম জোনে রূপান্তর করবেন না, আর অফসেট ছাড়া বিয়োগ করে সময়কাল বের করবেন না। একটি যাত্রায় সেগমেন্ট থাকে; টেকনিক্যাল স্টপসহ একটি সেগমেন্টে একাধিক লেগ থাকে। আপনার UI আর ডেটাকে একমত হতে হবে কোনটাকে "স্টপ" বলা হবে।
বিক্রির পরেও ঘটনা ঘটে
টিকিট ইস্যুর পরও এয়ারলাইন সময়সূচি বদলায়। ইস্যুর সময় ঠিক থাকা একটি বুকিং কয়েক সপ্তাহ পরে নতুন সময়, নতুন ফ্লাইট নম্বর বা ছিন্ন কানেকশন দেখাতে পারে, আর সরবরাহকারী অনুযায়ী আপনি তা জানবেন নোটিফিকেশন, কিউ বা বুকিং আবার আনার মাধ্যমে। ধরে নিন, আপনি নজর সরানোর পরেও বুকিং বদলাবে।
Void মানে রিফান্ড নয়
ইস্যুর কিছুক্ষণ পর সাধারণত একটি সময়-জানালা থাকে, যখন টিকিট void করা যায় যেন তা কখনো ছিলই না। তারপর কেবল ভাড়ার নিয়ম অনুযায়ী রিফান্ড সম্ভব, যাতে জরিমানা লাগতে পারে বা কিছুই ফেরত না আসতে পারে। জানালা ও তার নিয়ম সরবরাহকারী ও ইস্যুর চুক্তির; "বাতিল" বোতাম বানানোর আগে সেগুলো পড়ে নিন।
ভুলের দাম
ফ্লাইট ইন্টিগ্রেশনের ব্যর্থতা একটা নির্দিষ্টভাবে ব্যয়বহুল: এগুলো লগে নয়, মানুষের ঘাড়ে পড়ে। ডুপ্লিকেট বুকিং মানে এয়ারলাইনে ফোন আর হয়তো এজেন্সির অ্যাকাউন্টের বিরুদ্ধে মেমো। টাকা কাটা অথচ টিকিটহীন গ্রাহক মানে রিফান্ড, অভিযোগ আর চার্জব্যাকের ঝুঁকি। সফল পেমেন্ট ছাড়া ইস্যু হওয়া টিকিট মানে এয়ারলাইনের কাছে দেনা, যা কাউকে মেটাতে হবে। কেউ প্রক্রিয়া না করা সময়সূচি পরিবর্তন মানে বিমানবন্দরে দাঁড়ানো এক যাত্রী, যার ফ্লাইট আগেই ছেড়ে গেছে।
এর কোনোটিই স্বাভাবিক পথের টেস্টে ধরা পড়ে না। আগে অস্বাভাবিক পথগুলো লিখুন: বুকিংয়ের সময় টাইমআউট, বেড়ে যাওয়া দাম, PNR তৈরির পর ব্যর্থ টিকিট, সফল পেমেন্টের পর void। এগুলো সামলানো গেলে স্বাভাবিক পথটাই সহজ অংশ।
ফ্লাইট API-র বিপরীতে টেস্টিং
সরবরাহকারীর টেস্ট পরিবেশ কাজের, কিন্তু অসম্পূর্ণ। এগুলো সাধারণত প্রোডাকশনের চেয়ে শান্ত, তাই ক্লাস বিক্রি শেষ বা দাম বদলের ঘটনা কম, আর কয়েকটি টাইমআউট একেবারেই অনুকরণ করে না। কলের কাঠামো আর ভ্যালিডেশন ত্রুটি বোঝার জন্য এগুলো ব্যবহার করুন, তারপর প্রোডাকশনে নিয়ন্ত্রিত একটি রান পরিকল্পনা করুন — আসল বুকিং, যা জানালার মধ্যে void করবেন — আর অপারেশনস যেন জানে আপনি এটা করছেন।
আদৌ ইন্টিগ্রেট করবেন কি না, সেটা আলাদা প্রশ্ন। আপনার আসলে যদি নিজের সিস্টেমে কাঁচা ইনভেন্টরি নয়, একটি স্টোরফ্রন্ট দরকার হয়, তাহলে লাভ-ক্ষতির হিসাব আছে white label বনাম নিজের বুকিং ইঞ্জিন লেখায়, আর একই যুক্তি খাটে সাব-এজেন্টদের জন্য B2B পোর্টালের ক্ষেত্রেও। যদি সত্যিই নিজের কোডে ইনভেন্টরি চান, এই প্ল্যাটফর্ম ফ্লাইট ও হোটেল API দেয়, আর অ্যাক্সেস শুরু হয় সেলফ-সার্ভ কী দিয়ে নয়, আপনার ব্যবহারের ধরন নিয়ে আলাপ দিয়ে — ওপরের প্রতিটি প্রশ্ন করার জন্যও সেটাই সঠিক মুহূর্ত।