İçeriğe geç

Hız sınırı

Anahtar ve hesap başına istek sınırları, 429 yanıtı ve başlıklar.

Geliştirici belgesi

İstekler API anahtarı ve hesap başına sayılır:

Anahtar başına istek60 saniyelik pencerede 300 istek
Anahtar başına yazma (GET dışı)60 saniyelik pencerede 60 istek
Hesap başına istek (bütün anahtarlar)60 saniyelik pencerede 1.200 istek
  • Sınır aşılınca 429 rate_limited döner. Retry-After başlığı yeniden denemeden önce beklenecek saniyeyi söyler.
  • Yanıtlar RateLimit-Policy ve RateLimit başlıklarını taşır. Bu başlıklar IETF'in taslak belirtimidir; biçimleri taslakla birlikte değişebilir. İstemcinizi önce Retry-After'a göre kurun.
  • Sayaç API anahtarının ailesine bağlıdır: anahtarı döndürmek sayacı sıfırlamaz.
  • Başarısız kimlik denemeleri istemci adresi başına ayrı ve daha sıkı bir kovada sayılır. Bu kova dolunca o adresten gelen ve çözülemeyen anahtarlar 429 alır; geçerli anahtarlar çalışmaya devam eder.

Öneriler

  • Toplu eşitlemeyi büyük sayfalarla (limit=100) ve updated_since ile yapın (Sayfalama).
  • Değişiklikleri sık sık sormak yerine webhook kullanın.
  • 429 ve 503 yanıtlarında Retry-After kadar bekleyin; art arda hatalarda bekleme süresini artırın.