API রেফারেন্স
কুইক স্টার্ট
ছয়টি কলে একজন কাস্টমার ইমেইল থেকে টিকেটেড বুকিংয়ে পৌঁছায়। ক্রমানুসারে অনুসরণ করুন।
এটি সেই মেরুদণ্ড যা প্রতিটি Trip963 API স্টোরফ্রন্ট ইমপ্লিমেন্ট করে। প্রতিটি ধাপ বাম মেনুর একটি আসল এন্ডপয়েন্ট — পুরো কন্ট্রাক্ট চাইলে সেটি খুলুন।
১. কাস্টমারকে লগ ইন করান
স্টোরফ্রন্ট Origin হেডার এবং appKey + secret বডি দিয়ে POST /v2/auth/login। পাবেন accessToken। refreshToken কুকি সেট হয়ে যাবে। পরের প্রতিটি কলে বিয়ারার টোকেন পাঠান।
২. সার্চ শুরু করুন, তারপর পোল করুন
POST /v2/flight/init-search সাথে সাথে searchId দেয় — মানে সার্চ শুরু হয়েছে, ভাড়া এসেছে এমন নয়। GET /v2/flight/search-result/{id} করুন যতক্ষণ meta.completionPercent ১০০ না হয়। COMPLETED, PARTIAL ও FAILED মানে পোল বন্ধ।
৩. একটি ফ্লাইট খুলুন
GET /v2/flight/detail/{flightId}?searchId=… ব্র্যান্ডেড ফেয়ার গ্রুপ, ব্যাগেজ আর মার্কআপ-সহ টোটালের প্যাসেঞ্জার ভাগ ফেরায়।
৪. কার্ট, তারপর প্যাসেঞ্জার
ইটিনারেরি আইডি দিয়ে POST /v2/cart। পুরো প্যাসেঞ্জার তালিকা দিয়ে PUT /v2/cart/{id}। বয়স মাপা হয় ডিপারচারের দিন, আজকের দিনে নয়।
৫. রিভ্যালিডেট, তারপর PNR তৈরি
POST /v2/cart/validate-fare প্রোভাইডারকে জিজ্ঞেস করে ভাড়া সরছে কিনা। তারপর POST /v2/cart/create-pnr। কাস্টমার সবসময় পুরো টাকা দেয় — পার্শিয়াল পেমেন্ট সার্ভার থেকেই বন্ধ।
৬. টিকেট ইস্যু করুন
POST /v2/order/issue মালিকানাধীন অর্ডার টিকেট করে। পরে /v2/order/search দিয়ে হিস্টরি আর /v2/order/show/{id} দিয়ে একটি খুলুন। সেভ করা ট্রাভেলার /v2/travelers/search-এ।