Kaynaklar
Hatalar
code değerine göre belirleyin.Hata biçimi
{
"error": {
"code": "NOT_FOUND",
"message": "Sipariş bulunamadı"
}
}error.codeerror.messageerror.fieldsVALIDATION hatasında: alan yolu → ileti. İç içe alanlar noktayla yazılır (address.text, items.0.name).Doğrulama hataları
Eksik ya da hatalı alanlar 422 VALIDATION döner. message ilk hatayı, fields bütün hatalı alanları içerir; formunuzda ilgili alanın yanında gösterebilirsiniz.
{
"error": {
"code": "VALIDATION",
"message": "external_id: Geçersiz değer: beklenen string, alınan undefined",
"fields": {
"external_id": "Geçersiz değer: beklenen string, alınan undefined",
"address.lat": "Çok büyük: beklenen number <=90",
"total_amount": "Çok küçük: beklenen number >=0"
}
}
}Firmanın ayarlarından kaynaklanan bazı doğrulamalar alan adını iç adla verir; örneğin "Müşteri telefonu zorunlu" ayarı customer.phone yerine customer_phone anahtarıyla döner.
Bütün kodlar
API_KEY_REQUIREDİstekte API anahtarı yok ya da ks_ ile başlamıyor.
X-Api-Key başlığını ekleyin.
API_KEY_INVALIDAnahtar yanlış, silinmiş ya da pasif.
Kurye firmanızdan yeni anahtar isteyin. Yeniden denemeyin.
FORBIDDENİşlem kurye firmasının ayarlarıyla kapalı (ör. sipariş bu aşamada işletme tarafından iptal edilemez).
Kullanıcıya iletiyi gösterin; gerekirse kurye firmasıyla iletişime geçilir.
NOT_FOUNDSipariş ya da işletme bulunamadı. Anahtarınızın göremediği bir işletmenin siparişi de böyle görünür.
{ref} değerini ve işletme bilgisini denetleyin.
ALREADY_CANCELLEDSipariş zaten iptal edilmiş.
Başarılı sayabilirsiniz; siparişi iptal olarak işaretleyin.
ORDER_FINALSipariş sonuçlanmış (teslim edildi, teslim edilemedi); değiştirilemez.
Siparişin son durumunu GET /orders/{ref} ile alın.
OUT_OF_RANGEAdres, firmanın tanımladığı en fazla teslimat mesafesinin dışında.
Siparişi kurye firmasına göndermeyin; müşteriye bildirin.
OUT_OF_ZONEAdres hizmet bölgesinin dışında ya da ücret hesaplanamadı (çoğu zaman konum eksik).
Konum gönderdiğinizden emin olun; POST /quote ile önceden sınayın.
PAYMENT_TYPE_NOT_FOUNDpayment.kind türünde etkin bir ödeme tipi tanımlı değil.
GET /payment-types listesinden payment_type_id gönderin.
RESTAURANT_INACTIVEİşletme pasif durumda; sipariş alınmıyor.
Kurye firmasıyla iletişime geçin.
OPEN_ORDER_LIMITİşletmenin aynı anda açık sipariş sınırı doldu.
Açık siparişlerden biri sonuçlanınca tekrar deneyin.
CREDIT_LIMITİşletmenin cari borcu firmanın belirlediği sınırı aştı.
Kurye firmasıyla hesabı kapatın.
VALIDATIONEksik ya da hatalı alan. Hangi alanın neden reddedildiği fields içinde yazar.
İsteği düzeltin; aynı haliyle yeniden göndermeyin.
INVALID_JSONGövde geçerli bir JSON değil.
Gövdeyi ve Content-Type: application/json başlığını denetleyin.
BODY_TOO_LARGEGövde 2 MB'tan büyük.
Ürün listesini kısaltın.
RATE_LIMITEDyeniden denenebilirDakikalık istek sınırı aşıldı.
retry-after saniye bekleyip tekrar deneyin.
INTERNALyeniden denenebilirSunucuda beklenmeyen bir hata oluştu.
Kısa bir beklemeyle tekrar deneyin; sürerse kurye firmanıza bildirin.
Ne zaman yeniden denenir
- Yeniden deneyin:
429,5xx, zaman aşımı ve bağlantı hataları. Artan aralıklarla (ör. 1, 2, 4, 8 saniye) ve en çok birkaç kez. - Yeniden denemeyin:
400,401,403,404,409,422. Aynı istek aynı sonucu verir; isteği düzeltin ya da durumu kullanıcıya bildirin.
Sipariş oluştururken yeniden denemek güvenlidir: aynı external_id ikinci sipariş açmaz. Bkz. Yinelenen gönderim.