Hatalar
Her hata, kararlı ve makine tarafından okunabilir bir kod içeren bir RFC 7807 sorun belgesidir.
Sorun ayrıntıları
2xx dışındaki yanıtlar; status, title, detail, kararlı bir code (snake_case), hatalı istek özelliğini belirten isteğe bağlı bir field ve destekle iletişime geçtiğinizde belirtmeniz için bir traceId içeren application/problem+json taşır.
{
"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…"
}Karşılaşacağınız kodlar
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — kimlik doğrulama sorunları. 403 api_scope_missing (anahtarınızda bu kapsam yok), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (field ile). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (yalnızca canlı ortam — depozitonuzu yükleyin). 502 supplier_error — havayolu veya otel tedarikçisi başarısız oldu; aramayı yeniden deneyin.
Güvenli yeniden deneme
429'u Retry-After süresinden sonra, 502/503/504'ü üstel geri çekilme (exponential backoff) ile yeniden deneyin. 429 dışındaki hiçbir 4xx'i yeniden denemeyin. Taahhüt işlemlerini (siparişler, rezervasyonlar, düzenleme, iptal) yalnızca aynı Idempotency-Key ile yeniden deneyin. Bir arama oturumunun süresi dolarsa (404) yeni bir arama başlatın — teklif kimlikleri ve fiyat anahtarları oturumlar arasında geçerli değildir.