Başlangıç
Hata Kodları
API yanıtları standart HTTP durum kodlarını kullanır:
| Kod | Açıklama |
|---|---|
200 | İşlem (GET veya PUT) başarı ile sonuçlandı. |
201 | Oluşturma işlemi (POST) başarı ile sonuçlandı. |
204 | Silme isteği başarı ile sonuçlandı. (cevapta içerik bulunmaz.) |
400 | İstek gövdesi bozuk veya doğrulama hatası (alan bazlı hatalar errors içinde). |
401 | Access token eksik, geçersiz veya süresi dolmuş ya da Admin API'de istemcinin bu işlem için izni yok. |
403 | İstemcinin bu operasyona özel gerekli yetkileri yok. |
404 | Talep edilen nesne sunucuda bulunamadı. |
405 | Bu operasyon tipine (GET, POST, PUT veya DELETE) izin verilmiyor. |
429 | Belli bir süre içerisinde çok fazla istek yapıldı. |
500 | Sunucuda bir hata oluştu ve istek karşılanamadı. |
503 | Sunucu şu anda hizmet vermiyor (kapalı veya erişilemiyor). |
Doğrulama hataları 422 değil 400 koduyla döner.
Hata gövdesi
Uygulama kaynaklı hatalar (400, 403, 404, 500 ve Admin API'de izin hatası olan 401) aynı JSON gövdesini döner. errorMessage, x-ideasoft-locale istek başlığına göre çevrilir.
Code
| Alan | Açıklama |
|---|---|
code | HTTP durum kodu. |
errorMessage | Hata mesajı. |
errorCode | Uygulamaya özgü hata kodu: doğrulama hatalarında 300001, tanımsız hatalarda 0. |
errors | Doğrulama hataları. Admin API alan adı → mesaj nesnesi, Store API {alan adı: mesaj} nesnelerinden oluşan dizi döner. |
Access token eksik, geçersiz veya süresi dolmuşsa 401 yanıtı OAuth hata biçimindedir:
Code
Tekrar deneme
429 ve 5xx yanıtlarında isteği üstel geri çekilme (exponential backoff) ile tekrar denemeniz önerilir. 4xx hatalarında tekrar denemeyin; önce isteğinizi düzeltin.
Cloudflare Hataları
Endpoint'e ulaşmadan alınan Cloudflare kaynaklı hatalar için: Cloudflare hata kodları
Son güncelleme: