Σφάλματα
Κάθε αποτυχία είναι ένα έγγραφο προβλήματος RFC 7807 με σταθερό, αναγνώσιμο από μηχανή κωδικό.
Λεπτομέρειες προβλήματος
Οι αποκρίσεις που δεν είναι 2xx φέρουν application/problem+json με status, title, detail, έναν σταθερό code (snake_case), ένα προαιρετικό field που ονομάζει την προβληματική ιδιότητα του αιτήματος, και ένα traceId που αναφέρετε όταν επικοινωνείτε με την υποστήριξη.
{
"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…"
}Κωδικοί που θα συναντήσετε
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — προβλήματα αυθεντικοποίησης. 403 api_scope_missing (στο κλειδί σας λείπει το δικαίωμα), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (με field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (μόνο στην παραγωγή — αναπληρώστε την εγγύησή σας). 502 supplier_error — ο προμηθευτής αεροπορικής ή ξενοδοχείου απέτυχε· επαναλάβετε την αναζήτηση.
Ασφαλής επανάληψη
Επαναλάβετε το 429 μετά το Retry-After και τα 502/503/504 με εκθετική καθυστέρηση (backoff). Μην επαναλαμβάνετε ποτέ 4xx εκτός από 429. Επαναλάβετε δεσμεύσεις (παραγγελίες, κρατήσεις, έκδοση, ακύρωση) μόνο με το ίδιο Idempotency-Key. Αν λήξει μια συνεδρία αναζήτησης (404), ξεκινήστε νέα αναζήτηση — τα αναγνωριστικά προσφορών και τα κλειδιά τιμών δεν ισχύουν μεταξύ συνεδριών.