İstek Sınırlamaları (Rate Limit)

Tüm ComToHome API servisleri için sistem kaynaklarını korumak ve adil kullanım politikası sağlamak amacıyla istek başına belirli oran sınırlamaları (rate limit) uygulanmaktadır.

Rate Limit Politikaları

API istekleri için farklı endpoint'lere göre aşağıdaki sınırlamalar uygulanmaktadır:

Kategori	Limit	Süre	Açıklama
API Key	300 istek	1 dakika	Genel API istekleri için varsayılan limit
Gönderi Sorgula Servisleri	6.000 istek	1 dakika	Gönderi sorgulama endpoint'leri

Sliding Window: Tüm rate limit'ler "sliding window" (kayan pencere) politikası ile uygulanır. Bu, son 1 dakika içindeki toplam istek sayısının sürekli olarak hesaplandığı anlamına gelir.

Aşım Durumu

Belirtilen sınırın aşılması durumunda:

API 429 Too Many Requests yanıtı döner
İstemci, rate limit sıfırlanana kadar beklemelidir
X-RateLimit-Reset header'ı, kaç saniye sonra tekrar istek yapılabileceğini belirtir

Sınırlama Takibi

İstek sınırlamalarıyla ilgili bilgiye HTTP yanıt başlıkları (response headers) üzerinden erişilebilir:

Header Adı	Açıklama
`X-RateLimit-Limit`	Belirlenen maksimum istek sayısını belirtir
`X-RateLimit-Remaining`	Mevcut zaman dilimi içinde yapılabilecek kalan istek sayısı
`X-RateLimit-Reset`	Rate limit sıfırlanana kadar beklenecek süre (saniye). Limit aşılmadıysa `0`

Örnek Header Değerleri

Normal Durum

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 0

Limit Aşımı Durumu

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 45

Bu örnekte, kullanıcı limitini aşmış ve 45 saniye sonra tekrar istek yapabilecektir.