Fehler
Jeder Fehler ist ein Problemdokument nach RFC 7807 mit einem stabilen, maschinenlesbaren Code.
Problemdetails
Antworten außerhalb von 2xx liefern application/problem+json mit status, title, detail, einem stabilen code (snake_case), einem optionalen field, das die fehlerhafte Anfrageeigenschaft benennt, und einer traceId, die Sie angeben, wenn Sie den Support kontaktieren.
{
"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, denen Sie begegnen werden
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid – Authentifizierungsprobleme. 403 api_scope_missing (Ihrem Schlüssel fehlt die Berechtigung), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (mit field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (nur Produktion – laden Sie Ihre Einlage auf). 502 supplier_error – der Fluggesellschafts- oder Hotelanbieter ist ausgefallen; wiederholen Sie die Suche.
Sicher wiederholen
Wiederholen Sie 429 nach Retry-After und 502/503/504 mit exponentiellem Backoff. Wiederholen Sie niemals einen 4xx außer 429. Wiederholen Sie verbindliche Aktionen (Aufträge, Buchungen, Ausstellung, Stornierung) nur mit demselben Idempotency-Key. Läuft eine Suchsitzung ab (404), starten Sie eine neue Suche – Angebots-IDs und Raten-Schlüssel sind sitzungsübergreifend nicht gültig.