Son güncelleme
İstek limitleri
Ne kadar veri okuyabileceğinizi iki şey sınırlar: API anahtarı başına istek hızı ve cüzdandaki krediler. İlkine takılmak 429, ikincisinin bitmesi 402 döndürür.
İstek hızı
Limitler her API anahtarına ayrı ayrı uygulanır; sayıları çalışma alanının planı belirler. Bir anahtarın saniye başına bir limiti (kayan bir saniyelik pencere) ve UTC gece yarısında sıfırlanan bir günlük kotası vardır. Panel oturumları istek limitine tabi değildir.
| Plan | Saniye başına istek | Günlük istek | Etkin anahtar |
|---|---|---|---|
| Free | 1 | 5,000 | 1 |
| Starter | 5 | 15,000 | 3 |
| Pro | 20 | 100,000 | 10 |
| Scale | 60 | 400,000 | 25 |
| Agency / Enterprise | 150 | 1,200,000 | sınırsız |
Eksik bir kapsam veya modül nedeniyle reddedilen istekler (403) sayılmaz; kimlik doğrulamayı geçen her istek, sonucu ne olursa olsun sayılır.
Başlıklar
Limit denetiminden geçen her yanıt, kalan bütçeyi taşır. X-RateLimit-Limit ve X-RateLimit-Remaining saniye başına pencereyi tanımlar; Daily çifti, anahtarın günlük bir kotası olduğunda görünür.
HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431429 yanıtı neye benzer
Sınırlanan bir istek; rate_limit_exceeded koduyla, standart hata zarfıyla ve tam saniye cinsinden bir Retry-After başlığıyla 429 döndürür. Yeniden denemeden önce en az bu kadar bekleyin; yeniden sınırlanırsanız bekleme süresini üstel olarak artırın.
HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}Tükenmiş bir günlük kota, daily_quota_exceeded koduyla ve UTC gece yarısına kadar sayan bir Retry-After ile 429 döndürür. Kota başlıkları 429 yanıtının kendisinde gönderilmez.
Krediler
İstek hızından bağımsız olarak, her okuma çalışma alanı cüzdanından kredi olarak ölçülür. Önbellekten okumalar ucuzdur; yeni veri toplayan bir istek daha pahalıdır (bkz. Krediler). Tavana ulaşıldığında, önbellekten okumalar dahil ölçülen her çağrı credit_cap_exceeded koduyla 402 döndürür.
resetAt değerini izleyin ve LIVE olayları için yoklama yerine webhook’ları tercih edin.