Hata biçimi

Başarısız her cevap aynı gövdeyi taşır:

{ "message": "Bu tarih/saat için çakışan randevu var", "code": "SLOT_CONFLICT" }

• code kararlıdır; programınızın dallanması buna göre olmalı.
• message insan içindir ve değişebilir. Mağaza uçlarının mesajları Türkçedir; partner katmanının kendi mesajları Accept-Language: en ile İngilizce gelir.
• Bazı hatalar ek alan taşır (ör. SERVICE_AREA_NOT_COVERED için uncovered, ESCROW_EXISTS için mevcut escrow).

Doğrulama hataları

Gövde ya da sorgu şemaya uymazsa 400 VALIDATION_ERROR ve alan alan liste:

{
  "message": "İstek doğrulanamadı.",
  "code": "VALIDATION_ERROR",
  "location": "body",
  "issues": [
    {
      "path": "items.0.quantity",
      "message": "Too big: expected number to be <=99",
      "code": "too_big"
    }
  ]
}

Durum kodları

Durum	Anlamı
400	İstek geçersiz
401	Anahtar geçersiz (PARTNER_KEY_INVALID)
403	Rol ya da izin yetmiyor, ya da kayıt size ait değil
404	Kayıt yok ya da göremiyorsunuz
409	Kaydın durumu buna izin vermiyor (SLOT_CONFLICT, ESCROW_EXISTS…)
422	İşlenemeyen istek (SERVICE_AREA_NOT_COVERED…)
429	Hız sınırı (RATE_LIMITED)
5xx	Sunucu ya da dış servis hatası; yeniden deneyebilirsiniz

Her uçun döndürebileceği kodlar referansta o ucun cevaplarında listelenir.