Hibák
Minden hiba egy RFC 7807 szerinti problémadokumentum, stabil, géppel olvasható kóddal.
Hibarészletek
A nem 2xx válaszok application/problem+json formátumúak, és tartalmazzák a status, title és detail mezőt, egy stabil code-ot (snake_case), egy opcionális field mezőt, amely megnevezi a hibás kérés-tulajdonságot, valamint egy traceId-t, amelyet az ügyfélszolgálattal való kapcsolatfelvételkor adhat meg.
{
"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…"
}Gyakori kódok
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — hitelesítési problémák. 403 api_scope_missing (a kulcsából hiányzik a hatókör), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (field mezővel). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (csak éles környezetben — töltse fel a letétjét). 502 supplier_error — a légitársaság vagy a szállásbeszállító hibát adott; ismételje meg a keresést.
Biztonságos újrapróbálkozás
A 429-et a Retry-After után próbálja újra, az 502/503/504-et exponenciális visszalépéssel. A 429-en kívül más 4xx-et soha ne próbáljon újra. A véglegesítő műveleteket (rendelések, foglalások, kiállítás, lemondás) csak ugyanazzal az Idempotency-Key kulccsal próbálja újra. Ha egy keresési munkamenet lejár (404), indítson új keresést — az ajánlatazonosítók és árkulcsok munkamenetek között nem érvényesek.