Hata Yönetimi

Tüm hatalar standart bir JSON formatında döner.

Hata Şeması

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "guests[0].birth_date is required.",
    "request_id": "req_...",
    "documentation_url": "https://docs.tourmax.com.tr/getting-started/errors#validation-error",
    "details": [
      {"field": "guests[0].birth_date", "issue": "required"}
    ]
  }
}

HTTP Durum Kodları

Kod	Anlam	Yapılması Gereken
200 / 201	Başarılı	—
202	Kuyruğa alındı (iptal talebi vb.)	Webhook bildirimini bekleyin
400	Bozuk istek (JSON ayrıştırma hatası)	İstek gövdesinin biçimini kontrol edin
401	Token geçersiz veya süresi dolmuş	Yeni bir erişim tokenı alın
403	Yetersiz kapsam (scope) veya kaynak erişim izni yok	Token kapsamlarını kontrol edin
404	Kaynak bulunamadı	Referans/kimlik değerini kontrol edin
409	Çakışma (zaten iptal edilmiş, yinelenen referans vb.)	Mevcut durumu yeniden sorgulayın
422	Doğrulama hatası	details dizisini inceleyin
429	İstek limiti aşıldı	Retry-After süresi kadar bekleyin
500	Sunucu hatası	request_id ile destek ekibine bildirin

Hata Kodları

code	Açıklama
VALIDATION_ERROR	İstek gövdesi beklenen şema ile uyuşmuyor
INVALID_TOKEN	Token geçersiz, eksik veya süresi dolmuş
INSUFFICIENT_SCOPE	Token bu işlem için yeterli kapsama sahip değil
RESOURCE_NOT_FOUND	Rezervasyon, otel veya tur bulunamadı
CONFLICT	Çakışma (yinelenen client_reference_id, zaten iptal edilmiş vb.)
OFFER_EXPIRED	Teklif süresi dolmuş — yeniden fiyat sorgulayın
OFFER_CONSUMED	Teklif daha önce kullanılmış
PAYMENT_REQUIRED	Ödeme gerekli ancak ödeme akışı başlatılmamış
RATE_LIMITED	İstek limiti aşıldı
INTERNAL_ERROR	Sunucu tarafında beklenmeyen bir hata oluştu

Destek Talebi

Bir hatayı bildirirken aşağıdaki bilgileri mutlaka iletin:

• X-Request-Id başlığı (veya yanıttaki request_id alanı)
• İsteğin tam zaman damgası (saat dilimi dahil)
• Hata yanıtının tam gövdesi