Hatalar

Tüm hatalar aynı yapıda döner. HTTP kodu genel kategoriyi, errorCode alanı ise hatanın tam karşılığını ve yeniden denemenin sonuç verip vermeyeceğini belirtir.

{
  "success": false,
  "message": "Bu mağazanın kurye şirketi şu anda sipariş alamıyor.",
  "data": {
    "errorCode": "FLEET_SUSPENDED",
    "retryable": false,
    "action": "Mağaza için başka bir kurye şirketi seçilmeli."
  }
}

message alanı doğrudan son kullanıcıya gösterilebilir. Uygulama mantığınızı ise errorCode alanı üzerine kurun; mesaj metinleri değişebilir, kodlar değişmez.

Kod listesi

İstek biçimi

Kod	errorCode	Neden	Yeniden dene
400	MALFORMED_REQUEST	Gövde çözümlenemedi: geçersiz JSON, boş gövde ya da bir alanın beklenen türde olmaması	Hayır — gövdeyi düzeltin

Bu yanıtın data.fields alanı, sorunu oluşturan alanların adlarını taşır:

{
  "success": false,
  "message": "fleetId alanı beklenen türde değil.",
  "data": {
    "errorCode": "MALFORMED_REQUEST",
    "retryable": false,
    "fields": ["fleetId"]
  }
}

422 kodlarından farkı şudur: 422 gövdenin okunabildiği, ancak içeriğin bir kuralı çiğnediği anlamına gelir. 400 ise gövdenin hiç okunamadığını gösterir.

Kimlik doğrulama

Kod	errorCode	Neden	Yeniden dene
401	TOKEN_EXPIRED	Token'ın süresi dolmuş	Evet — yenileyin, isteği bir kez gönderin
401	INVALID_CREDENTIALS	Anahtar hatalı, iptal edilmiş ya da hesap kapalı	Hayır

Mağaza

Kod	errorCode	Neden	Yeniden dene
409	STORE_NOT_CONFIGURED	Kurye şirketi bağlanmamış ya da mağaza kapalı	Hayır
409	ALREADY_HIZLIYO_PARTNER	Şube doğrudan Hızlıyo üyesi	Hayır
409	STORE_EXISTS_ON_ANOTHER_VENDOR	Şube başka bir POS firmasında kayıtlı	Hayır
409	DUPLICATE_STORE	Şube, hesabınızda farklı bir mağaza kimliğiyle kayıtlı — mevcut kaydı kullanın	Hayır
422	INVALID_TAX_NUMBER	Vergi numarası eksik ya da hatalı	Hayır

Sipariş

Kod	errorCode	Neden	Yeniden dene
423	FLEET_SUSPENDED	Kurye şirketi ticari nedenle sipariş kabul edemiyor	Hayır — mağazaya başka şirket bağlanmalı
423	FLEET_TERMINATED	Kurye şirketinin hesabı kapatılmış	Hayır
503	FLEET_UNAVAILABLE	İlgili bölgede müsait kurye yok	Evet — 60 saniye sonra
422	DROPOFF_OUT_OF_COVERAGE	Adres kurye şirketinin hizmet bölgesi dışında	Hayır
422	COORDINATE_MISMATCH	Koordinatlar Türkiye sınırları dışında	Hayır — veriyi düzeltin
422	INVALID_RECIPIENT	Alıcı adı eksik ya da çok kısa	Hayır
422	INVALID_PHONE	Telefon numarası 10 haneli geçerli bir numara değil	Hayır
422	INVALID_ADDRESS	Adres metni çok kısa	Hayır
422	READY_AT_TOO_FAR	readyAt 4 saatten uzak bir zamanı gösteriyor	Hayır
409	DUPLICATE_ORDER	Aynı externalOrderId farklı içerikle gönderildi	Hayır
409	CANCEL_TOO_LATE	Paket kurye tarafından teslim alınmış	Hayır
404	ORDER_NOT_FOUND	orderId kayıtlı değil ya da başka bir hesaba ait	Hayır

İstek limiti

Kod	errorCode	Neden	Yeniden dene
429	RATE_LIMITED	İstek limiti aşıldı	Evet — Retry-After süresi kadar sonra

Yeniden denemenin sonuç verdiği kodlar

Yalnızca üç kodda yeniden deneme anlamlıdır: TOKEN_EXPIRED, FLEET_UNAVAILABLE ve RATE_LIMITED. Diğerleri ya bir karara ya da gönderilen veride bir soruna işaret eder. Yeniden gönderim aynı yanıtı üretir ve istek limitinizi tüketir.

Başarısız isteklerin sizin adınıza yeniden denenmediğini göz önünde bulundurun. Bkz. Siparişler › Yeniden gönderim.

Restorana iletilecek mesajlar

Restoran sizin kullanıcınızdır. Aşağıdaki örnekler, hata kodlarının son kullanıcıya nasıl aktarılacağını göstermektedir:

Kod	Yetersiz mesaj	Önerilen mesaj
FLEET_UNAVAILABLE	"Teslimat hatası"	"Şu anda müsait kurye bulunmuyor, yeniden deneniyor."
FLEET_SUSPENDED	"423 hatası"	"Kurye şirketiniz sipariş kabul etmiyor, lütfen şirketle görüşün."
COORDINATE_MISMATCH	"Geçersiz istek"	"Harita üzerindeki konum geçersiz, işareti kontrol edin."
STORE_NOT_CONFIGURED	"Mağaza hatası"	"Bu şube için henüz kurye şirketi seçilmemiş."

Beklenmeyen hatalar

503 FLEET_UNAVAILABLE dışındaki 5xx yanıtlar Hızlıyo tarafında bir sorun oluştuğu anlamına gelir. Bu yanıtlar takip numarasıyla kayıt altına alınır. Bize iletirken gönderdiğiniz orderId veya X-Idempotency-Key değerini ve yaklaşık işlem saatini ekleyin.