Fouten
Elke fout is een RFC 7807-probleemdocument met een stabiele, machineleesbare code.
Probleemdetails
Niet-2xx-responses bevatten application/problem+json met status, title, detail, een stabiele code (snake_case), een optioneel field dat de betreffende verzoekeigenschap noemt, en een traceId om te vermelden wanneer u contact opneemt met support.
{
"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…"
}Codes die u tegenkomt
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — authenticatieproblemen. 403 api_scope_missing (uw sleutel mist de scope), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (met field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (alleen productie — vul uw deposito aan). 502 supplier_error — de luchtvaart- of hotelleverancier faalde; probeer de zoekopdracht opnieuw.
Veilig opnieuw proberen
Probeer 429 opnieuw na Retry-After, en 502/503/504 met exponentiële backoff. Probeer nooit een andere 4xx dan 429 opnieuw. Probeer vastleggende acties (orders, boekingen, uitgeven, annuleren) alleen opnieuw met dezelfde Idempotency-Key. Verloopt een zoeksessie (404), start dan een nieuwe zoekopdracht — offer-ID's en tariefsleutels zijn niet geldig over sessies heen.