Hata kodları
Tüm hatalar aynı zarfla döner. İstemciniz tek biçim bekleyebilir.
{
"error": {
"code": "invalid_key",
"message": "API anahtarı geçersiz."
}
}Doğrulama hatalarında hangi alanların hatalı olduğu ek olarak döner:
{
"error": { "code": "validation_failed", "message": "..." },
"fields": ["pickup_district", "weight_tier", "pickup_lat"]
}Kodlar
| HTTP | Kod | Ne zaman |
|---|---|---|
| 401 | missing_authorization | Authorization başlığı yok |
| 401 | invalid_authorization | Başlık biçimi hatalı |
| 401 | invalid_key | Anahtar tanınmıyor |
| 401 | key_revoked | Anahtar iptal edilmiş |
| 403 | account_suspended | Hesap askıya alınmış |
| 403 | identity_verification_required | Kimlik doğrulaması tamamlanmamış |
| 400 | invalid_body | Gövde geçerli JSON değil |
| 400 | validation_failed | Zorunlu alan eksik veya geçersiz |
| 400 | invalid_weight_tier | weight_tier geçerli değil. İzinli: 0-5, 5-10, 10-15, 15-20. Eski 0-10 / 10-20 artık reddedilir |
| 400 | konum_isaretlenmedi | Koordinat alanları eksik ya da sayı değil |
| 400 | durak_adresi_eksik | Ek teslimat noktası adressiz. stops gönderin; yalnızca extra_stops sayısı yeterli değil |
| 400 | durak_konumu_eksik | Ek teslimat noktasının lat/lng değeri yok |
| 400 | gecersiz_durak_listesi | stops bir dizi değil |
| 422 | hizmet_bolgesi_disi | Koordinatlar hizmet bölgesinin dışında |
| 422 | gecersiz_mesafe | Hesaplanan mesafe koordinatlarla tutarsız |
| 502 | mesafe_hesaplanamadi | Yol mesafesi şu anda alınamadı. Tekrar denenebilir |
| 400 | invalid_extra_stops | Ek nokta sayısı sınır dışı |
| 400 | invalid_crossing | Tanınmayan köprü/tünel |
| 400 | invalid_declared_value | Gönderi değeri beyanı geçersiz |
| 422 | declared_value_too_high | Beyan, kabul edilen azami değerin üzerinde |
| 422 | assurance_unavailable | Gönderi güvencesi kapalı; değer beyanı kabul edilmiyor |
| 404 | order_not_found | Sipariş yok ya da sizin değil |
| 409 | order_not_cancellable | Kurye atanmış ya da durum uygun değil |
| 422 | cash_not_available | Kapıda nakit için ilk 3 sipariş kartla tamamlanmalı |
| 429 | rate_limited | Dakikalık istek sınırı aşıldı |
| 500 | server_misconfigured | Sunucu yapılandırması eksik |
| 500 | internal_error | Beklenmeyen hata |
Güvenlik notu
Başkasına ait bir sipariş numarası sorulduğunda 403 değil 404 order_not_found döner. Bu bilinçlidir: 403 dönmek, o numarada bir siparişin var olduğunu doğrulardı.