İçeriğe geç
Başlangıç

Hata Kodları

API yanıtları standart HTTP durum kodlarını kullanır:

KodAçıklama
200İşlem (GET veya PUT) başarı ile sonuçlandı.
201Oluşturma işlemi (POST) başarı ile sonuçlandı.
204Silme 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).
401Access 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.
404Talep edilen nesne sunucuda bulunamadı.
405Bu operasyon tipine (GET, POST, PUT veya DELETE) izin verilmiyor.
429Belli bir süre içerisinde çok fazla istek yapıldı.
500Sunucuda bir hata oluştu ve istek karşılanamadı.
503Sunucu ş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.

JSONCode
{ "code": 400, "errorMessage": "Validation Error.", "errorCode": 300001, "errors": { "name": "This value should not be blank." } }
AlanAçıklama
codeHTTP durum kodu.
errorMessageHata mesajı.
errorCodeUygulamaya özgü hata kodu: doğrulama hatalarında 300001, tanımsız hatalarda 0.
errorsDoğ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:

JSONCode
{ "error": "invalid_grant", "error_description": "The access token provided is invalid." }

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: