ফ্লাইট API

ভাড়ার ক্যালেন্ডার

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 রুটটির জন্য প্রতিদিনের সবচেয়ে সস্তা ক্যাশ করা ভাড়া আপনার মুদ্রায় ফেরত দেয়, সঙ্গে ক্যাশ কতটা সাম্প্রতিক তা-ও। প্রতিটি তারিখ-জোড়ার রাউন্ড-ট্রিপ মোটের জন্য returnFrom / returnTo যোগ করুন, আর শ্রেণি সীমিত করতে cabin। এটি আমাদের প্রাইস ক্যাশ থেকে দেওয়া হয় — তাৎক্ষণিক, এবং কখনো সরবরাহকারী অনুসন্ধান হিসেবে গণ্য হয় না — তাই আসল অনুসন্ধানের আগে একটি ক্যালেন্ডার বা “সবচেয়ে সস্তা দিন” স্ট্রিপ আঁকতে এটি ব্যবহার করুন।

অনুসন্ধান

POST /v1/flights/search — একমুখী যাত্রার জন্য একটি slice, রিটার্নের জন্য দুটি, মাল্টি-সিটির জন্য সর্বোচ্চ ছয়টি; ধরন অনুযায়ী যাত্রীর সংখ্যা; ঐচ্ছিক কেবিন ও সর্বোচ্চ স্টপের সংখ্যা (maxStops)। wait=true দিলে সব সরবরাহকারী উত্তর দেওয়ার পর রেসপন্সে প্রতিটি অফার থাকে; wait=false দিলে আপনি একটি searchId পান এবং complete true না হওয়া পর্যন্ত cursor দিয়ে GET /v1/flights/search/{searchId} পোল করেন।

প্রতিটি অফারে থাকে একটি অস্বচ্ছ offerId, প্রতি যাত্রীর বিভাজনসহ আপনার মুদ্রায় মোট দাম, slices → segments (এয়ারলাইন, ফ্লাইট নম্বর, সময়, বিমান, কেবিন, ব্যাগেজ), ভাড়ার শর্তের সারসংক্ষেপ এবং মেয়াদ। অফারগুলো সার্চ সেশনের পুরো সময় (প্রায় 20 মিনিট) বৈধ থাকে।

দাম ও নিয়ম

POST /v1/flights/offers/{offerId}/price কমিট করার ঠিক আগে সরবরাহকারীর সঙ্গে ভাড়া পুনঃযাচাই করে এবং নিশ্চিত দাম, কর ও এয়ারলাইনের প্রয়োজনীয় যাত্রী-ফিল্ড (ডকুমেন্ট, জন্মতারিখ, ফ্রিকোয়েন্ট ফ্লায়ার) ফেরত দেয়। GET .../fare-rules জরিমানার বিবরণ ফেরত দেয়; GET .../ancillaries অর্ডারে যোগ করা যায় এমন সশুল্ক ব্যাগ ও বিকল্পের তালিকা দেয়।

বাড়তি সেবা (অতিরিক্ত ব্যাগেজ)

GET /v1/flights/offers/{offerId}/ancillaries ওই ভাড়ায় এয়ারলাইনের দেওয়া সশুল্ক অতিরিক্ত সেবার তালিকা দেয় — আপাতত অতিরিক্ত চেক-ইন ব্যাগেজ, প্রতিটির সঙ্গে একটি key, পিস / ওজন এবং প্রতি যাত্রীর দাম। সশুল্ক মানে এগুলোর দাম ভাড়ার উপরে ধরা হয় এবং অর্ডারের সঙ্গে বিল করা হয়, অফারে দেখানো অন্তর্ভুক্ত বরাদ্দের মতো নয়।

এগুলো কিনতে POST /v1/flights/orders-এ ancillaries[] যোগ করুন: প্রতিটি অতিরিক্ত সেবার জন্য একটি এন্ট্রি, key ও passengerIndex (passengers-এ 0-ভিত্তিক সূচক) সহ। এগুলোর দাম, বুকিং ও টিকিট ইস্যু অর্ডারের সঙ্গেই হয় এবং অর্ডারের টিকিটের মোটে দেখা যায়। যে অর্ডারের টিকিট ইতিমধ্যে ইস্যু হয়েছে তাতে অতিরিক্ত সেবা যোগ করা যায় না; আসন নির্বাচনও একই ধাঁচে আসবে।

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

অর্ডার তৈরি করুন

POST /v1/flights/orders — offerId, যাত্রী (পাসপোর্টে যেমন নাম, ধরন, জন্মতারিখ, আন্তর্জাতিক ভ্রমণপথের জন্য ডকুমেন্ট), যোগাযোগের তথ্য এবং ঐচ্ছিক ancillaries[] (উপরে দেখুন) দিয়ে; একটি Idempotency-Key যোগ করুন। আপনি পাবেন একটি orderId, এয়ারলাইনের PNR, টিকিট ইস্যুর সময়সীমা এবং held অবস্থা। স্যান্ডবক্সে অর্ডারটি সরবরাহকারীর টেস্ট সিস্টেমে যায় এবং কোনো চার্জ হয় না; প্রোডাকশনে ডিপোজিট সংরক্ষিত রাখা হয়।

টিকিট ইস্যু করুন

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key আবশ্যক) ই-টিকিট ইস্যু করে এবং প্রতি যাত্রীর টিকিট নম্বর ফেরত দেয়। যেকোনো সময় GET /v1/flights/orders/{orderId} দিয়ে অর্ডারটি পড়ুন; অবস্থা held → issued → cancelled/refunded ধাপে এগোয়।

ভয়েড, বাতিল ও ফেরত

GET /v1/flights/orders/{orderId}/refund-quote জানায় ভাড়ার নিয়ম অনুযায়ী বাতিল করলে কত ফেরত আসবে (একই দিনের ভয়েড সাধারণত বিনামূল্যে)। POST /v1/flights/orders/{orderId}/cancel এটি কার্যকর করে; ফেরতের অর্থ আপনার ডিপোজিট লেজারে জমা হয়, যা ডেভেলপার পোর্টালে দেখা যায়।