Xatolar
Har bir xato barqaror, mashina oʻqiy oladigan kodga ega RFC 7807 muammo hujjatidir.
Muammo tafsilotlari
2xx boʻlmagan javoblar application/problem+json formatida boʻladi va status, title, detail, barqaror code (snake_case), soʻrovning muammoli xususiyatini koʻrsatuvchi ixtiyoriy field hamda qoʻllab-quvvatlash xizmatiga murojaat qilganda keltiriladigan traceId ni oʻz ichiga oladi.
{
"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…"
}Duch keladigan kodlaringiz
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — autentifikatsiya muammolari. 403 api_scope_missing (kalitingizda doira yoʻq), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (field bilan). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (faqat production — depozitingizni toʻldiring). 502 supplier_error — aviakompaniya yoki mehmonxona yetkazib beruvchisi ishlamadi; qidiruvni takrorlang.
Xavfsiz qayta urinish
429 ni Retry-After dan keyin, 502/503/504 ni esa eksponensial kechiktirish bilan qayta urining. 429 dan boshqa 4xx ni hech qachon qayta urinmang. Majburiyat amallarini (buyurtmalar, bronlar, rasmiylashtirish, bekor qilish) faqat oʻsha Idempotency-Key bilan qayta urining. Agar qidiruv sessiyasi muddati tugasa (404), yangi qidiruv boshlang — taklif ID lari va narx kalitlari sessiyalar orasida amal qilmaydi.