Feil
Hver feil er et RFC 7807-problemdokument med en stabil, maskinlesbar kode.
Problemdetaljer
Svar som ikke er 2xx, har application/problem+json med status, title, detail, en stabil code (snake_case), et valgfritt field som angir den aktuelle forespørselsegenskapen, og en traceId du oppgir når du kontakter kundeservice.
{
"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…"
}Koder du vil møte
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid – autentiseringsproblemer. 403 api_scope_missing (nøkkelen din mangler tilgangen), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (med field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (bare i produksjon – fyll på depositumet ditt). 502 supplier_error – flyselskapet eller hotelleverandøren feilet; prøv søket på nytt.
Trygge nye forsøk
Prøv 429 på nytt etter Retry-After, og 502/503/504 med eksponentielt økende ventetid. Prøv aldri en annen 4xx enn 429 på nytt. Prøv forpliktende operasjoner (ordrer, bestillinger, utstedelse, kansellering) på nytt bare med samme Idempotency-Key. Hvis en søkeøkt utløper (404), start et nytt søk – tilbuds-ID-er og prisnøkler er ikke gyldige på tvers av økter.