Hata Kodları

HTTP Durum Kodları

Kod	Durum	Açıklama
200	OK	İstek başarılı
201	Created	Sipariş oluşturuldu
400	Bad Request	Eksik veya hatalı parametre
401	Unauthorized	API Key eksik veya hatalı
404	Not Found	Kaynak bulunamadı
409	Conflict	Mükerrer kayıt
500	Internal Server Error	Sunucu hatası

Hata Yanıt Formatı

{
  "error": "Hata açıklaması"
}

Yaygın Hatalar

Webhook Hataları

Hata	Sebep	Çözüm
restaurantId required	Getir header eksik	Entegrasyon kaydını kontrol edin
vendorId required	YS body'de vendorId yok	YS entegrasyonunu kontrol edin
merchantId required	Migros body'de merchantId yok	Migros kaydını kontrol edin
no active integration	Entegrasyon bulunamadı	Platform ve restoran ID'yi doğrulayın
integration inactive	Entegrasyon pasif	Entegrasyonu aktifleştirin
failed to parse order	JSON formatı hatalı	Payload yapısını kontrol edin

Status Update Hataları

Hata	Sebep	Çözüm
providerOrderId required	Alan eksik	providerOrderId gönderin
platform required	Alan eksik	platform gönderin
action required	Alan eksik	action gönderin
integration not found	Entegrasyon eşleşmedi	providerRestaurantId header'ını kontrol edin
sequence guard: X after Y	Mantıksız geçiş	Doğru sırayı takip edin

Kimlik Doğrulama Hataları

Hata	Sebep	Çözüm
X-Internal-Api-Key required	Header eksik	Internal API Key ekleyin
unauthorized	Yanlış API Key	Doğru anahtarı kullanın
X-API-Key required	Migros API key eksik	Migros entegrasyon ayarlarını kontrol edin

Rate Limiting

Şu an aktif bir rate limit uygulanmamaktadır. Ancak kötüye kullanım durumunda IP bazlı sınırlama uygulanabilir.

Hata Yönetimi

1. Her API çağrısında HTTP status kodunu kontrol edin
2. error alanındaki mesajı loglayın
3. 5xx hatalarında exponential backoff ile retry yapın
4. 4xx hatalarında payload'ınızı düzeltin, retry yapmayın