এরর
প্রতিটি ব্যর্থতা একটি স্থিতিশীল, মেশিনে পাঠযোগ্য কোডসহ RFC 7807 সমস্যা ডকুমেন্ট।
সমস্যার বিবরণ
নন-2xx রেসপন্স application/problem+json বহন করে, যাতে থাকে status, title, detail, একটি স্থিতিশীল code (snake_case), সমস্যাযুক্ত রিকোয়েস্ট প্রপার্টির নাম দেওয়া একটি ঐচ্ছিক field, এবং সহায়তার সঙ্গে যোগাযোগের সময় উল্লেখ করার জন্য একটি traceId।
{
"type": "https://dubaitrip.com/docs/api/errors#price_changed",
"title": "Price changed",
"status": 409,
"detail": "The fare is now 412.50 USD (was 398.00 USD). Re-price and confirm.",
"code": "price_changed",
"traceId": "00-3f2a…"
}যেসব কোড আপনি পাবেন
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — প্রমাণীকরণের সমস্যা। 403 api_scope_missing (আপনার কী-তে স্কোপটি নেই), api_ip_not_allowed, api_partner_suspended। 429 api_rate_limited, api_quota_exceeded। 400 validation_failed (field সহ)। 404 search_session_not_found, order_not_found, booking_not_found। 409 offer_expired, rate_expired, price_changed। 402 insufficient_credit (কেবল প্রোডাকশনে — আপনার ডিপোজিট টপ-আপ করুন)। 502 supplier_error — এয়ারলাইন বা হোটেল সরবরাহকারী ব্যর্থ হয়েছে; অনুসন্ধান আবার চেষ্টা করুন।
নিরাপদে পুনরায় চেষ্টা
429 হলে Retry-After-এর পরে আবার চেষ্টা করুন, আর 502/503/504 হলে এক্সপোনেনশিয়াল ব্যাকঅফ দিয়ে। 429 ছাড়া অন্য কোনো 4xx কখনো আবার চেষ্টা করবেন না। কমিট (অর্ডার, বুকিং, ইস্যু, বাতিল) কেবল একই Idempotency-Key দিয়ে আবার চেষ্টা করুন। কোনো সার্চ সেশনের মেয়াদ শেষ হলে (404) নতুন অনুসন্ধান শুরু করুন — অফার আইডি ও রেট কী এক সেশন থেকে অন্য সেশনে বৈধ নয়।