| Durum Kodu | Hata | Açıklama |
|---|---|---|
| 400 | Bad Request | Hatalı JSON gönderildiğinde ya da isteğin içeriği kurallara uymadığında döner. Örnekler: seçilen taşıyıcı için firmanıza ait fiyat listesi tanımlı değil, seçilen taşıyıcı kapıda kredi kartı ödemesini desteklemiyor, iade gönderilerinde kapıda ödeme kullanılamaz. |
| 401 | Unauthorized | Yetkisiz erişim hatası. Token gönderilmemiş, geçersiz/süresi dolmuş ya da isteği yapan kullanıcının bu işlem için yetkisi yok. |
| 402 | Payment Required | Cüzdan (wallet) bakiyeniz yetersiz olduğu için işlem tamamlanamadı (örn: barkod oluşturma). Bakiye yüklemesi yapıp tekrar deneyiniz. |
| 404 | Not Found | İstek atılan URL bulunamadı ya da sorgulanan kayıt (gönderi, adres vb.) mevcut değil. Örnek: zpl-pure barkod tipi için hesabınızda yetki yoksa da bu kod döner. |
| 405 | Method Not Allowed | İstekteki HTTP method'unu (GET/POST vb.) kontrol ediniz; ilgili endpoint bu method'u desteklemiyor. |
| 422 | Validation Error | Doğrulama hatası. Gönderilen alanlardan biri zorunlu/format/limit kurallarına uymuyor (error nesnesinde alan bazlı detaylar döner). Ayrıca gönderi üzerinde halihazırda bir işlem yapılıyorsa ya da Aras Kargo gönderilerinde adres no güncellenmeye çalışılıyorsa da bu kod döner. |
| 429 | Too Many Requests | API istek oranı sınırını aştınız (rate limit). Limitiniz belirtilen saniye içinde sıfırlanacaktır; isteklerinizi yavaşlatınız. |
| 500 | Server Error | Beklenmeyen bir servis hatası oluştu. Cevapta dönen Takip No (#eventId) ile Müşteri Hizmetleri'ne başvurabilirsiniz. |
| 502 | Bad Gateway | Bağlı olduğumuz dış servis (örn: ZPL barkod servisi) hata döndü. Bir süre sonra tekrar deneyiniz. |
| 503 | Service Unavailable | Bağlı olduğumuz dış servise (örn: ZPL barkod servisi) şu anda ulaşılamıyor ya da ilgili özellik geçici olarak devre dışı. Lütfen daha sonra tekrar deneyiniz. |