এনভায়রনমেন্ট, সীমা ও সংস্করণ

স্যান্ডবক্স ও প্রোডাকশন, একটিই বেস URL

বেস URL: https://api.dubaitrip.com/v1। স্যান্ডবক্স ও প্রোডাকশন এটি ভাগ করে নেয়; আপনি যে কী দিয়ে স্বাক্ষর করেন সেটিই এনভায়রনমেন্ট নির্ধারণ করে। একটি dt_sbx_ কী আমাদের সরবরাহকারীদের টেস্ট এনভায়রনমেন্টে চলে — অনুসন্ধান, দাম নির্ধারণ, দর যাচাই, অর্ডার, বুকিং, টিকিট ইস্যু ও বাতিল সবই টেস্ট ইনভেন্টরিতে শুরু থেকে শেষ পর্যন্ত কাজ করে, কোনো প্রকৃত টিকিট বা ভাউচার ছাড়া এবং কোনো চার্জ ছাড়াই। প্রোডাকশন পর্যালোচনার পর ইস্যু করা একটি dt_live_ কী লাইভ ইনভেন্টরিতে পৌঁছায় এবং আপনার ডিপোজিট থেকে নিষ্পত্তি হয়।

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

রেট লিমিট ও কোটা

প্রতিটি কী একটি টোকেন বাকেট (প্রতি সেকেন্ডে স্থায়ী রিকোয়েস্ট ও একটি বার্স্ট) এবং একটি দৈনিক কোটা দিয়ে নিয়ন্ত্রিত। স্যান্ডবক্সের ডিফল্ট: 2 রিকোয়েস্ট/সেকেন্ড, বার্স্ট 5, 2,000 রিকোয়েস্ট/দিন। প্রোডাকশনের সীমা প্রতি অ্যাকাউন্টে সম্মতির ভিত্তিতে ঠিক হয়। বাকেট ছাড়িয়ে গেলে Retry-After হেডারসহ 429 api_rate_limited উত্তর আসে; কোটা শেষ হলে মধ্যরাত UTC পর্যন্ত 429 api_quota_exceeded উত্তর আসে।

ভারী অনুসন্ধান নকশাগতভাবেই অ্যাসিনক্রোনাস: সঙ্গে সঙ্গে একটি searchId পেতে wait=false পাঠান এবং সার্চ এন্ডপয়েন্ট পোল করুন, অথবা এক কলেই সম্পূর্ণ ফলাফল পেতে wait=true পাঠান। পোলিং অন্য যেকোনো রিকোয়েস্টের মতোই আপনার সীমায় গণ্য হয়।

লুক-টু-বুক সুরক্ষা

আপনার করা বুকিংয়ের তুলনাতেও অনুসন্ধান সীমিত করা হয়। একটি চলমান সময়সীমার (ডিফল্টভাবে 7 দিন) প্রতিটি দিন বিনামূল্যের একটি অনুসন্ধান বরাদ্দ দেয়, এবং সেই সময়সীমায় করা প্রতিটি বুকিং আরও cap সংখ্যক অনুসন্ধান যোগ করে — cap হলো আপনার অ্যাকাউন্টের জন্য সম্মত ও ডেভেলপার পোর্টালে দেখানো প্রতি বুকিংয়ে অনুসন্ধানের সংখ্যা। পোল, দাম যাচাই, ভাড়ার নিয়ম ও কনটেন্ট পড়া কখনো গণ্য হয় না; কেবল ফ্লাইট ও হোটেল অনুসন্ধান কল গণ্য হয়।

বরাদ্দ শেষ হলে অনুসন্ধান Retry-After হেডারসহ 429 look_to_book_exceeded উত্তর দেয়, যা পরবর্তী মধ্যরাত UTC নির্দেশ করে, যখন সময়সীমার সবচেয়ে পুরোনো দিনটি বাদ পড়ে। একটি বুকিং সঙ্গে সঙ্গে বরাদ্দ আবার খুলে দেয়। ডেভেলপার পোর্টালের লুক-টু-বুক কার্ডে লাইভ কাউন্টার, সীমা ও বাকি অংশ দেখা যায়; আপনার ইন্টিগ্রেশন ন্যায্যভাবেই বুকিংয়ের চেয়ে অনেক বেশি অনুসন্ধান করলে, প্রত্যাখ্যানের মধ্যে বারবার চেষ্টা না করে আমাদের সীমা বাড়াতে বলুন।

আইডেমপোটেন্সি

যে এন্ডপয়েন্টগুলো অর্থ বা ইনভেন্টরি কমিট করে — অর্ডার বা বুকিং তৈরি, ইস্যু, বাতিল — সেগুলোতে একটি Idempotency-Key হেডার প্রয়োজন (128 অক্ষর পর্যন্ত যেকোনো অনন্য স্ট্রিং; UUID আদর্শ)। একই কী দিয়ে পুনরায় চেষ্টা করলে ডুপ্লিকেট তৈরির বদলে মূল রেসপন্স ফেরত আসে; পুনর্ব্যবহৃত কীর অধীনে ভিন্ন বডি পাঠালে 409 উত্তর আসে।

সংস্করণ

সংস্করণটি পাথে থাকে (/v1)। সংযোজনমূলক পরিবর্তন — নতুন ঐচ্ছিক ফিল্ড, নতুন enum মান, নতুন এন্ডপয়েন্ট — সংস্করণ না বাড়িয়েই আসে, তাই সতর্কভাবে পার্স করুন এবং অজানা ফিল্ড উপেক্ষা করুন। সামঞ্জস্য ভাঙা পরিবর্তন মাইগ্রেশনের সময়সহ নতুন প্রধান সংস্করণে আসে; চেঞ্জলগ গাইডে প্রতিটি পরিবর্তন তালিকাভুক্ত থাকে।