Chyby
Každé selhání je dokument problému podle RFC 7807 se stabilním strojově čitelným kódem.
Podrobnosti o problému
Odpovědi mimo 2xx nesou application/problem+json se status, title, detail, stabilním code (snake_case), volitelným field označujícím problematickou vlastnost požadavku a traceId, které uveďte při kontaktu s podporou.
{
"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…"
}Kódy, se kterými se setkáte
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — problémy s ověřením. 403 api_scope_missing (vašemu klíči chybí oprávnění), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (s field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (jen v produkci — doplňte zálohu). 502 supplier_error — letecký nebo hotelový dodavatel selhal; zopakujte vyhledávání.
Bezpečné opakování
429 opakujte po uplynutí Retry-After, 502/503/504 s exponenciálním odstupem (exponential backoff). Žádnou jinou chybu 4xx než 429 nikdy neopakujte. Závazné operace (objednávky, rezervace, vystavení, storno) opakujte jen se stejným Idempotency-Key. Pokud relace vyhledávání vyprší (404), spusťte nové vyhledávání — ID nabídek a klíče cen neplatí napříč relacemi.