Kaynaklar

Hata Kodları

Tüm uç noktalar aynı yanıt biçimini ve HTTP kod kümesini kullanır.

Yanıt Biçimi

Başarılı istekler success: true ve data alanıyla döner. Hatalı istekler success: false ve okunabilir bir message ile döner.

başarılı

{
  "success": true,
  "data": { ... }
}

Alan	Tip	Ne Zaman
success	boolean	Her yanıtta bulunur.
message	string	Hata yanıtlarında okunabilir açıklama.
data	object \| array	Başarılı yanıtlarda yük.

Kod	Anlamı	Ne Yapmalı
200	OK	İstek başarıyla tamamlandı.
201	Created	Kayıt oluşturuldu, yanıttaki data alanını kullanın.
400	Bad Request	Gövde veya parametreleri kontrol edin.
401	Unauthorized	API anahtarını ve Authorization header’ını kontrol edin.
403	Forbidden	Hesabınızın bu kaynağa erişim yetkisi yok.
404	Not Found	Belirtilen kimlikle bir kayıt bulunamadı.
429	Too Many Requests	İstek limitini aştınız, bir süre bekleyip tekrar deneyin.
500	Internal Server Error	Sunucu tarafında hata oluştu, tekrar deneyin veya destek ile iletişime geçin.

Hata	Kod	Çözüm
Geçersiz API anahtarı	401	Authorization header'ındaki anahtarı kontrol edin.
Restorana paket atanmamış	403	Restorana Paket Ata uç noktasıyla önce paket tanımlayın.
Sipariş bulunamadı	404	orderId'nin doğru ve size ait bir siparişe ait olduğunu doğrulayın.
İstek limiti aşıldı	429	İsteklerinizi seyreltin veya artan aralıkla tekrar deneyin.
Eksik/geçersiz gövde alanı	400	Gövde alanları tablosunu ilgili uç nokta sayfasından kontrol edin.
Restoran bulunamadı	404	restaurantId'nin doğru ve hesabınıza ait olduğunu doğrulayın.
Entegrasyon pasif	—	Sipariş düşmez. Entegrasyon Durumunu Güncelle uç noktasıyla aktif edin.

429 ve 5xx yanıtlarında artan aralıkla (exponential backoff) tekrar denemeniz önerilir. Ayrıntılar için Hız Limitleri sayfasına bakın.