Hızlı Başlangıç

Hız Limitleri ve Engelleme Kuralları

API'yi kullanırken dikkat etmeniz gereken limitler ve kısıtlamalar. Limitleri aşmak erişiminizin geçici olarak engellenmesine neden olabilir.

Genel Hız Limiti

Bir API anahtarı için 10 saniyede en fazla 50 istek yapabilirsiniz. Limite takıldığınızda429 Too Many Requests yanıtı alırsınız; yanıt başlıklarında kalan hakkınızı ve ne zaman tekrar deneyebileceğinizi görürsünüz.

Yanıt başlıkları

Alan	Tip	Açıklama
X-RateLimit-Limit	int	Pencere başına izin verilen istek (50)
X-RateLimit-Remaining	int	Bu pencerede kalan istek hakkınız
X-RateLimit-Window	int	Pencere uzunluğu (saniye, 10)
Retry-After	int	Tekrar denemeden önce beklenecek süre (saniye)

429 Too Many Requests

{ "error": { "message": "Hız limiti aşıldı. 10 saniyede en fazla 50 istek.", "code": "rate_limited", "status": 429 } }

İsteklerinizi düzenli aralıklara yayın; 429 aldığınızda Retry-Afterkadar bekleyip üstel geri çekilme (exponential backoff) ile tekrar deneyin.

Hata Oranı Limiti

İsteklerinizin cevaplarını loglayıp API'den dönen hataları inceleyerek hatalı isteklerinizi düzeltmenizi öneririz. Yüksek hata oranı, otomatik engellemeye yol açar. Webhook akışlarınızı ise Arsigo'ya200 döndükten sonra çalıştırmanız tavsiye edilir.

API Çağrıları için Engelleme Kuralları

Engelleme	Koşul
30 dakikalık engelleme	Hata oranı ≥ %60 ve 1 saat içinde > 300 istek
12 saatlik engelleme	Hata oranı ≥ %60 ve 1 gün içinde > 3.000 istek
Kalıcı engelleme	Hata oranı ≥ %60 ve 5 gün içinde > 9.000 istek

Webhook'lar için Engelleme Kuralları

Engelleme	Koşul
15 dakikalık engelleme	Hata oranı ≥ %70 ve 30 dakika içinde > 10 istek
1 saatlik engelleme	Hata oranı ≥ %70 ve 3 saat içinde > 60 istek
Kalıcı engelleme	Hata oranı ≥ %70 ve 1 gün içinde > 240 istek

Engelleme süresi dolana kadar o anahtarla yapılan tüm istekler reddedilir. Kalıcı engelleme durumunda destek ekibiyle iletişime geçin.