API রেফারেন্স
ওভারভিউ
Trip963 API একটি পূর্ণ ফ্লাইট স্ট্যাকের বি২সি সারফেস — দুইটি সার্ভিস, একটি কাস্টমার যাত্রা, পনেরোটি এন্ডপয়েন্ট।
আপনি যদি নিজের ব্র্যান্ডে ট্রাভেল ওয়েবসাইট চালান, তাহলে সার্চ, কার্ট, PNR আর টিকেটিং আবার তৈরি করার দরকার নেই। Trip963 API আপনার স্টোরফ্রন্টকে একটি কাস্টমার-সেফ কন্ট্রাক্ট দেয়: লাইভ ফ্লাইট, ক্রেতা বুঝতে পারে এমন ভাড়া, আর এমন বুকিং যা শুধু সেই কাস্টমারের।
সামনে কোনো গেটওয়ে নেই। আপনার স্টোরফ্রন্ট দুইটি হস্টকে কল করে, দুটোই /v2 বোঝে। অথ থাকে ইউজার সার্ভিসে। উড়ানোর সবকিছু থাকে বুকিংয়ে।
রেসপন্স
{
"message": "Success",
"data": {},
"error": null,
"timeStamp": "02-09-2026 15:30:00"
}বেস URL
ইউজার (অথ): https://user.aerolink.dev — /v2/auth/*
বুকিং (বাকি সব): https://booking.aerolink.dev — ফ্লাইট, কার্ট, অর্ডার, ট্রাভেলার।
টেন্যান্ট ও স্টোরফ্রন্ট
প্রতিটি রিকোয়েস্ট অথেন্টিকেশনের আগে Host সাবডোমেইন থেকে টেন্যান্ট-রাউটেড হয় (ডিফল্ট বেস ডোমেইন trip963.com)। একটি বি২সি স্টোরফ্রন্ট নিজে টেন্যান্ট নয় — এটি ফাউন্ডিং টেন্যান্টে চলে। এর সাবডোমেইন রিজার্ভড তালিকায় থাকতে হবে, নাহলে বি২সি কোড চলার আগেই API ৪০০ দিয়ে প্রত্যাখ্যান করে।
অথেন্টিকেশন মডেল
POST /v2/auth/login ও POST /v2/auth/refresh খোলা। বাকি সব — GET /v2/auth/me সহ — চায় Authorization: Bearer <accessToken>। রিফ্রেশ টোকেন JSON-এ আসে না। এটি refreshToken নামের HttpOnly কুকি, শুধু হস্টের জন্য, তাই API হস্ট এমন হতে হবে যেখানে স্টোরফ্রন্ট কুকি পাঠাতে পারে।
সাকসেস এনভেলপ
প্রতিটি সফল উত্তর একটি ResponseModel। টাইমস্ট্যাম্প ফরম্যাট dd-MM-yyyy HH:mm:ss।
কাস্টমার যে অর্থ দেখে
অঙ্কগুলো নয়-ফিল্ডের B2cFare, কলারের POS কারেন্সিতে আগেই কনভার্ট করা। কোনো বি২সি পেইলোডে agentPrice, কস্টিং, MRP, কমিশন, মার্কআপ, PCC বা প্রোভাইডার থাকে না। total যা কাস্টমার দেয় — এজেন্ট ভাড়া প্লাস স্টোরফ্রন্ট মার্কআপ, প্রতি বুকিংয়ে একবার।
পেজিং
সার্চ এন্ডপয়েন্ট ফেরায় content, page, size, totalElements, totalPages, last। কোয়েরি প্যারাম pageNum (ডিফল্ট ০) ও pageSize (ডিফল্ট ১০)।