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.
Maksimum İstek Sayısı: Kullanıcı/ApiKey başına en fazla 250 istek/dakika yapılabilir.
Aşım Durumu: Belirtilen sınırın aşılması durumunda istemci, bir sonraki istek için 1 dakika beklemek zorundadır. Aksi halde 429 – Too Many Requests yanıtı ile karşılaşır.
İstek sınırlamalarıyla ilgili bilgiye HTTP yanıt başlıkları (response headers) üzerinden erişilebilir. Bu başlıklar, istemcinin mevcut sınıra ne kadar yaklaştığını ve ne zaman yeniden istek yapabileceğini gösterir.
| Header Adı | Açıklama |
|---|---|
X-RateLimit-Limit |
Belirlenen maksimum istek sayısını belirtir. Varsayılan olarak 250. |
X-RateLimit-Remaining |
Mevcut zaman dilimi içinde yapılabilecek kalan istek sayısını gösterir. Örneğin, 249 değeri, yalnızca 1 istek yapılmış olduğunu gösterir. |
X-RateLimit-Reset |
Eğer limit aşılırsa, rate limit’in sıfırlanacağı ve istek yapılmasına tekrar ne zaman izin verileceğini belirtir. Limit henüz aşılmadıysa bu değer genellikle 0 olur. Limit aşıldığında, saniye cinsinden ne kadar sonra tekrar istek yapılabileceği bilgisini verir (örneğin 60). |
X-RateLimit-Limit: 250
X-RateLimit-Remaining: 249
X-RateLimit-Reset: 0