İstekler, tüm anahtarların paylaştığı tek bir 60 saniyelik kayan hesap penceresini kullanır. Hesabın kademesini ömür boyu korunan başarılı harcama belirler; IP ve işlem korumaları daha erken veya ayrı olarak reddedebilir. Saatlik ya da anahtar başına kota yoktur.
20.000 istek / dakika / IP adresiAnahtar doğrulamasından önce uygulanır, böylece kaba kuvvet anahtar sıralaması sınırlıdır. Aynı IP arkasındaki tüm anahtarlar arasında paylaşılır. Varsayılan, genel olarak belirlenir ve kullanıcı tarafından yapılandırılamaz.
Kayan 60 saniyede 120–2.400 istekBir hesaptaki tüm aktif API anahtarları aynı sayacı tüketir. Doğrudan özel RPM ayarı yoksa limiti ömür boyu başarılı harcama basamağı belirler.
İşleme bağlıdırBazı hassas işlemler daha dar bir hesap kuralı ekler. Örneğin cancel, hesap başına dakikada 30 istek kabul eder; 429 yanıtı action bildirir.
Uygunluk, hesabın ömrü boyunca korunan başarılı harcamaya göre belirlenir. Tamamlanan ve kısmi teslimat korunan başarılı tutarı ekler; sonraki iadeler azaltır. Etkin limit günlük bir görev olmadan saklanan toplamdan güncellenir. Kazanılan kademeyi ve etkin RPM’yi görmek için action=account_status kullanın.
| Kademe | En az ömür boyu harcama | İstek / dakika |
|---|---|---|
| 0 | $0.00000000 | 120 |
| 1 | $10.00000000 | 300 |
| 2 | $50.00000000 | 600 |
| 3 | $100.00000000 | 900 |
| 4 | $500.00000000 | 1,200 |
| 5 | $1000.00000000 | 1,800 |
| 6 | $2500.00000000 | 2,400 |
| Header | Açıklama |
|---|---|
| X-RateLimit-Limit | Normal yanıtlarda hesabın paylaşılan etkin dakika başı istek limiti. 429 yanıtında reddeden katmanın bildirdiği limit. |
| X-RateLimit-Remaining | Normal yanıtlarda paylaşılan hesap penceresinde kalan istekler. 429 yanıtında reddeden katmanın bildirdiği kalan değer. |
| X-RateLimit-Reset | Bildirilen pencerenin sıfırlanmasına kalan göreli saniye; Unix zaman damgası değildir. |
| X-RateLimit-Tier | Ömür boyu başarılı harcamayla kazanılan kademe (0–6). Özel RPM geçersiz kılması bu değeri değiştirmez. |
| X-RateLimit-Source | Etkin RPM sabit basamaktan geliyorsa "tier"; doğrudan yönetici geçersiz kılmasından geliyorsa "custom". |
| X-RateLimit-DeniedBy | Adlandırılmış bir sınırlayıcı çağrıyı reddettiğinde 429 yanıtında gönderilir: "ip", "api_requests_per_minute" veya "action". |
| Retry-After | Yeniden denenebilir 429 veya 503 yanıtında tekrar denemeden önce Retry-After değerindeki saniye kadar bekleyin. action=add için bekledikten sonra aynı idempotency anahtarını kullanın. |
ip, api_requests_per_minute ve action reddeden katmanı gösterir; anahtar değiştirmek paylaşılan hesap, IP veya işlem limitini aşmaz.action=status ile uzlaştırmalıdır.