Hız Sınırları
API istekleri, abonelik paketinize göre API anahtarı başına hız sınırına tabidir. Sınırlar dakika başına kayan pencere üzerinden uygulanır.
Paket Bazlı Sınırlar
Hız sınırları abonelik paketine göre değişir:
| Plan | İstek / Dakika | Günlük Limit |
|---|---|---|
| Starter | 60 | 10,000 |
| Growth | 300 | 50,000 |
| Elite | 1,000 | 200,000 |
Hız Sınırı Başlıkları
Her API yanıtı, yanıt başlıklarında hız sınırı bilgisi içerir:
| Başlık | Açıklama |
|---|---|
X-RateLimit-Limit |
Mevcut pencerede izin verilen maksimum istek sayısı |
X-RateLimit-Remaining |
Mevcut pencerede kalan istek sayısı |
X-RateLimit-Reset |
Hız sınırının sıfırlandığı Unix zaman damgası |
Örnek Yanıt Başlıkları
HTTP/1.1 200 OK X-RateLimit-Limit: 300 X-RateLimit-Remaining: 287 X-RateLimit-Reset: 1732780800
Sınırı Aşma
Hız sınırını aştığınızda 429 yanıtı alırsınız:
Örnek 429 Yanıtı
429 Too Many Requests
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Please retry after 42 seconds.",
"retry_after": 42
}
}
En İyi Uygulamalar
- 429 yanıtı aldığınızda üstel geri çekilme uygulayın
- Veriler sık değişmediğinde yanıtları yerel olarak önbelleğe alın
- Sınırlara ulaşmamak için X-RateLimit-Remaining başlıklarını izleyin
- Toplam istek sayısını azaltmak için ilgili işlemleri gruplayın