Rate limit ve günlük kota
Her API anahtarı servis bazında dakikalık hız, burst ve günlük kota taşır. Değerler anahtar oluşturulurken yönetilir.
Her API anahtarı servis bazında dakikalık hız, burst ve günlük kota taşır. Değerler anahtar oluşturulurken yönetilir.
Response header'ları
Anahtarlı yanıtlarda aşağıdaki alanları okuyun:
RateLimit-Limit: 60
RateLimit-Remaining: 42
RateLimit-Reset: 37
RateLimit-Policy: 60;w=60
| Header | Anlamı |
|---|---|
RateLimit-Limit | Pencere için yapılandırılmış limit |
RateLimit-Remaining | Mevcut instance/pencere değerlendirmesinde kalan istek |
RateLimit-Reset | Reset'e kalan yaklaşık saniye |
RateLimit-Policy | Limit ve pencere politikası |
Retry-After | 429 sonrasında beklenmesi gereken saniye |
İki farklı 429
Hız limiti
Problem slug: rate-limit-exceeded. Kısa süre bekleyip Retry-After sonrasında tekrar deneyin.
Günlük kota
Problem slug: quota-exceeded. quotaResetAt alanı yeni UTC gün sınırını bildirir. Otomatik kısa retry yapmayın.
Dağıtık sayaç davranışı
Hız sayaçları servis instance'ı başınadır. Bu nedenle pratik toplam throughput, tek anahtar için yapılandırılan değerin bir miktar üstüne çıkabilir. Bu limitler kötüye kullanım ve maliyet tavanıdır; kesin faturalama ölçümü değildir.
Günlük kullanım bellekte sayılıp toplu yazıldığından kapanış veya eşzamanlı instance durumunda küçük aşım payı olabilir. Gün sınırı UTC'dir.
Önerilen retry
429 rate-limit-exceeded:Retry-After+ küçük jitter429 quota-exceeded:quotaResetAtzamanına kadar durdur502/503: en fazla 2–3 deneme, exponential backoff + jitter- Diğer 4xx: request veya config düzeltilmeden tekrar deneme
Birden çok worker aynı anahtarı kullanıyorsa retry koordinasyonu yapın; aksi halde thundering herd oluşabilir.