HTTP katmanı
| Durum | Nerede | Olası neden | Çözüm |
|---|---|---|---|
| 400 ya da 401 | Token isteği | client_id, client_secret ya da grant_type hatalı | Özel uygulama bilgilerini kontrol edin |
| 401 | GraphQL isteği | Token süresi doldu ya da Bearer öneki eksik | Yeni token alıp bir kez tekrarlayın |
| 400 | Görsel yükleme | url ve base64 birlikte gönderildi | İkisinden yalnız birini gönderin |
| 429 | Her yerde | 10 saniyede 50 istek sınırı aşıldı | Bekleyip artan aralıkla tekrar deneyin |
| 5xx | Her yerde | ikas tarafında geçici sorun | Kısa bekleyip tekrar deneyin |
GraphQL errors alanı
GraphQL'de bir istek HTTP olarak başarılı görünse de yanıtta errors dizisi bulunabilir. ikas'ın örnek kodu yanıttan data ve errors alanlarını birlikte okur. Bu dizi şu durumlarda dolar:
- Sorgu sözdizimi hatalı ya da şemada olmayan bir alan istendi.
- İşlem başka bir sürümde bulunuyor; ör. v1'e özgü bir işlem v2 adresine gönderildi.
- Token'ın izni o işlem için yetmiyor.
- Girdi değeri geçersiz; ör. zorunlu alan eksik ya da tip uyuşmuyor.
errors doluysa işlemi başarılı saymayın, mesajı kaydedin ve aynı isteği düzeltmeden tekrarlamayın.
Toplu işlemlerde satır bazlı hata
v2'deki saveVariantStocks ve updateVariantPrices gibi toplu işlemler bir errors listesi döndürür. Her öğe errorCode, inputArrayIndex ve gönderilen inputData alanlarını taşır. inputArrayIndex, gönderdiğiniz dizideki sırayı gösterir; hatalı satırı bu sırayla bulursunuz.
v1'deki saveProductStockLocations ve saveVariantPrices ise yalnız true ya da false döndürür. false geldiğinde hangi satırın sorun çıkardığı yanıttan anlaşılmaz; grubu küçültüp yeniden denemek gerekir.
Engelleme ve hata oranı
ikas son bir saatte hata oranı yüzde 25'i geçen uygulamayı bir saat engeller; yüzde 60'ı geçen ve çok istek atan uygulamaya 30 dakika, 12 saat ya da kalıcı engelleme uygulanır. Engelleme sırasında tüm istekler reddedilir. Ayrıntı: istek sınırları ve engelleme.
Bu yüzden hata yönetimi yalnız kullanıcıya mesaj göstermek değildir; hatalı isteği tekrarlayan döngüleri kırmak, engellenmemenin de yoludur.
Sık sorulanlar
ikas API 200 döndü ama işlem yapılmadı, neden?
GraphQL hataları yanıtın errors alanında gelir. HTTP durumu yerine errors alanına ve v1 işlemlerinde dönen true ya da false değerine bakın.
v2 toplu stok güncellemesinde bazı satırlar neden işlenmedi?
Hatalı satırlar errors listesinde errorCode ve inputArrayIndex ile döner. Bu satırları düzeltip yalnız onları yeniden gönderin.
ikas 401 hatası nasıl çözülür?
Token süresi dolmuş olabilir. Yeni bir token alıp isteği tekrarlayın. Token isteği de 401 dönüyorsa client_id ve client_secret değerlerini kontrol edin.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı