Galat
Setiap kegagalan adalah dokumen masalah RFC 7807 dengan kode stabil yang dapat dibaca mesin.
Detail masalah
Respons non-2xx membawa application/problem+json dengan status, title, detail, sebuah code yang stabil (snake_case), field opsional yang menyebut properti permintaan yang bermasalah, dan traceId untuk disebutkan saat Anda menghubungi dukungan.
{
"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…"
}Kode yang akan Anda temui
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — masalah autentikasi. 403 api_scope_missing (kunci Anda tidak memiliki cakupan tersebut), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (dengan field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (hanya produksi — isi ulang deposit Anda). 502 supplier_error — pemasok maskapai atau hotel gagal; ulangi pencarian.
Mencoba ulang dengan aman
Ulangi 429 setelah Retry-After, dan 502/503/504 dengan exponential backoff. Jangan pernah mengulangi 4xx selain 429. Ulangi operasi komit (pesanan, pemesanan, penerbitan, pembatalan) hanya dengan Idempotency-Key yang sama. Jika sesi pencarian kedaluwarsa (404), mulai pencarian baru — ID penawaran dan kunci tarif tidak berlaku lintas sesi.