Začínáme

Limity požadavků

Každý uživatel může odeslat až 120 požadavků za minutu, a to za všechny své klíče dohromady. Počítadlo se nuluje na začátku každé minuty.

Odpovědi na požadavky s platným klíčem ukazují čerpání limitu v těchto hlavičkách:

Název	Typ	Popis
`X-RateLimit-Limit`	`integer`	Počet povolených požadavků za minutu.
`X-RateLimit-Remaining`	`integer`	Kolik požadavků v aktuální minutě ještě zbývá.
`X-RateLimit-Reset`	`integer`	Počet sekund do vynulování počítadla.
`Retry-After`	`integer`	Jen v odpovědi `429`: počet sekund, po které musíte počkat, než to zkusíte znovu.

Při překročení limitu je odpovědí 429 s kódem rate_limited. Než to zkusíte znovu, počkejte dobu uvedenou v Retry-After.

Pokusy bez platného klíče (bez klíče, s chybným nebo odvolaným klíčem) jsou omezeny na 30 pokusů za minutu z každé IP adresy.

Jak nepřekročit limit

Používejte per_page až do 100, abyste získali více položek s menším počtem požadavků.
Ke sledování stavu TV stačí jeden požadavek za minutu.
U velkých úloh rozložte požadavky v čase a sledujte X-RateLimit-Remaining.

Hlavičky odpovědi200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

Limit dosažen429

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}