কুইক স্টার্ট

1. স্যান্ডবক্স ক্রেডেনশিয়াল নিন

ট্রাভেল API পৃষ্ঠায় নিবন্ধন করুন। আপনার ইমেল যাচাই হলেই আপনার পার্টনার অ্যাকাউন্ট তৈরি হয়ে যায় এবং স্ক্রিনে একটি স্যান্ডবক্স কী আইডি দেখানো হয়; সিক্রেটটি একই ঠিকানায় পাঠানো একটি এককালীন প্রকাশ-লিংকের মাধ্যমে দেওয়া হয়। এটি আপনার সিক্রেট ম্যানেজারে সংরক্ষণ করুন — এটি ঠিক একবারই দেখানো হয়।

আপনি ডেভেলপার পোর্টালের জন্য একটি অস্থায়ী পাসওয়ার্ডও পান, যেখানে আপনি কী তৈরি ও রোটেট করতে, IP অনুমোদন তালিকা সেট করতে, ব্যবহার দেখতে এবং প্রোডাকশনের অনুরোধ করতে পারেন।

2. প্রতিটি রিকোয়েস্ট স্বাক্ষর করুন

প্রতিটি কলে চারটি হেডার থাকে: X-API-Key (আপনার কী আইডি), X-Timestamp (unix সেকেন্ড), X-Nonce (16–128টি এলোমেলো অক্ষর) এবং X-Signature — একটি ক্যানোনিকাল স্ট্রিংয়ের ছোট হাতের hex HMAC-SHA256, আপনার সিক্রেটকে কী হিসেবে নিয়ে।

ক্যানোনিকাল স্ট্রিং হলো নিউলাইন দিয়ে জোড়া পাঁচটি লাইন: বড় হাতের HTTP মেথড, ঠিক যেভাবে পাঠানো হয়েছে সেভাবে পাথ ও কোয়েরি স্ট্রিং, টাইমস্ট্যাম্প, নন্স, এবং কাঁচা বডির ছোট হাতের hex SHA-256 (খালি বডির হ্যাশ হয় শূন্য বাইটের SHA-256)। টাইমস্ট্যাম্প আমাদের ঘড়ির 300 সেকেন্ডের মধ্যে থাকতে হবে; একটি নন্স 10 মিনিটের মধ্যে একবারই ব্যবহার করা যায়।

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. আপনার প্রথম কল করুন

স্যান্ডবক্সে একটি ফ্লাইট খুঁজুন। স্যান্ডবক্স আমাদের সরবরাহকারীদের টেস্ট এনভায়রনমেন্টের সঙ্গে যুক্ত, তাই অনুসন্ধানে টেস্ট ইনভেন্টরি ও দাম আসে, আর সেখানে করা বুকিং একটি টেস্ট বুকিং — কোনো আসল টিকিট নেই, কোনো চার্জ নেই। প্রতিটি রেফারেন্স পৃষ্ঠায় cURL, Node.js, Python ও PHP-তে সম্পূর্ণ নমুনা আছে — কপি করুন, আপনার কী আইডি ও সিক্রেট বসান, চালান।

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. একটি বুকিং ফ্লো সম্পূর্ণ করুন

ফ্লাইট: অনুসন্ধান → বেছে নেওয়া অফারের দাম যাচাই → যাত্রী ও যোগাযোগের তথ্যসহ অর্ডার তৈরি → টিকিট ইস্যু → (ঐচ্ছিক) ফেরতের কোট নিয়ে অনুরোধ। হোটেল: অনুসন্ধান → একটি আবাসনের কক্ষগুলো দেখা → দর যাচাই → বুকিং তৈরি → (ঐচ্ছিক) কোট নিয়ে বাতিল।

অফার আইডি ও রেট কী অস্বচ্ছ এবং স্বল্পস্থায়ী। কমিট করার ঠিক আগে সবসময় দাম বা দর যাচাই করুন: দাম বদলে গেলে আপনি নতুন পরিমাণসহ 409 price_changed পাবেন, আর সিদ্ধান্ত আপনার।

5. প্রোডাকশনের অনুরোধ করুন

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