Genel sınır
| Kural | Değer |
|---|---|
| İstek sınırı | 10 saniyede en fazla 50 istek |
| Aşılınca | 429 Too Many Requests; yanıtta kalan hak görülür |
| Hata oranı sınırı | Son 1 saatte hata oranı yüzde 25'i geçerse 1 saat otomatik engelleme |
| Engelleme sırasında | Süre dolana kadar tüm istekler reddedilir |
Değerler ikas'ın Rate Limits ve Engelleme Kuralları sayfasından alındı. ikas, sınırları aşmanın erişimin geçici olarak engellenmesine yol açabileceğini belirtir.
API çağrıları için engelleme kuralları
| Süre | Koşul |
|---|---|
| 30 dakika | Hata oranı yüzde 60 ve üzeri, 1 saatte 300'den fazla istek |
| 12 saat | Hata oranı yüzde 60 ve üzeri, 1 günde 3000'den fazla istek |
| Kalıcı | Hata oranı yüzde 60 ve üzeri, 5 günde 9000'den fazla istek |
Kalıcı engelleme, uzun süre fark edilmeden hata üreten bir zamanlanmış işin en ağır sonucudur. Hatalı her isteği kaydedin ve aynı hatayı veren isteği sonsuza kadar tekrarlamayın.
Webhook'lar için engelleme kuralları
| Süre | Koşul |
|---|---|
| 15 dakika | Hata oranı yüzde 70 ve üzeri, 30 dakikada 10'dan fazla istek |
| 1 saat | Hata oranı yüzde 70 ve üzeri, 3 saatte 60'tan fazla istek |
| Kalıcı | Hata oranı yüzde 70 ve üzeri, 1 günde 240'tan fazla istek |
ikas, webhook'ta önce 200 döndürüp işinizi sonra çalıştırmanızı önerir. Bildirimi işlerken uzun süren ya da hata veren bir uç adres, webhook hata oranını yükseltir.
Sınıra takılmadan çalışmak
- Liste sorgularında limit değerini yüksek tutun (en fazla 200); daha az sayfa, daha az istek demektir.
- Stok ve fiyatı tek tek değil, toplu işlemlerle gönderin. v1 ve v2 fiyat işlemleri tek istekte 3000 satıra kadar kabul eder.
- 429 aldığınızda bekleyip tekrar deneyin; tekrarlar arasındaki süreyi artırın.
- Doğrulama hatası veren isteği aynı veriyle tekrarlamayın; önce veriyi düzeltin.
- Token'ı süresi boyunca saklayın; her istekte token almak gereksiz trafik üretir.
- Hata oranını kendi tarafınızda da ölçün; ikas'ın eşiklerine yaklaşmadan uyarı alırsınız.
Sık sorulanlar
ikas API istek sınırı nedir?
ikas'ın belgesine göre genel sınır 10 saniyede en fazla 50 istektir. Aşıldığında 429 Too Many Requests döner.
ikas API neden erişimimi engelledi?
Büyük olasılıkla hata oranı sınırı aşıldı. Son bir saatte isteklerin yüzde 25'inden fazlası hatalıysa erişim bir saat kapanır; daha yüksek oranlarda süre uzar.
Kalıcı engelleme nasıl önlenir?
Hatalı istekleri kaydedin, aynı hatayı tekrarlayan işleri durdurun ve veriyi düzeltmeden yeniden göndermeyin. Hata oranını izleyen bir uyarı kurmak en güvenli yoldur.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı