Hız sınırı ve önbellek

Kaç istek gönderebileceğin, bunu bildiren başlıklar ve neyin saklanacağı.

Dakikada 120 istek

Her adres herkese açık API'ye dakikada 120 istek gönderebilir. Sayım her saat dakikasının başında yeniden başlar; oraya kaç saniye kaldığını RateLimit-Reset söyler.

Nerede olduğunu gösteren başlıklar

Her yanıt şu başlıkları taşır: pencerenin kaç isteğe izin verdiğini söyleyen RateLimit-Limit, kaç isteğin kaldığını söyleyen RateLimit-Remaining ve pencerenin yeniden başlamasına kalan saniyeyi söyleyen RateLimit-Reset.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Sınırı aştığında

Sınırı aşan istek, saniye cinsinden bir Retry-After başlığıyla 429 rate_limited döndürür. Sonraki istekten önce o kadar bekle; arada daha fazla istek göndermek bekleme süresini kısaltmaz.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Bir kopya sakla

Katalog verisi günde en çok birkaç kez değişir. Kullandığın yanıtları sakla ve her ziyaretçi için yeniden sormak yerine belirli aralıklarla yenile. Bazı yanıtlar ne kadar süre güncel kalacağını söyleyen bir Cache-Control başlığı taşır.