Začíname

Limity požiadaviek

Každý používateľ môže odoslať až 120 požiadaviek za minútu, a to za všetky svoje kľúče spolu. Počítadlo sa nuluje na začiatku každej minúty.

Odpovede na požiadavky s platným kľúčom ukazujú čerpanie limitu v týchto hlavičkách:

Názov	Typ	Popis
`X-RateLimit-Limit`	`integer`	Počet povolených požiadaviek za minútu.
`X-RateLimit-Remaining`	`integer`	Koľko požiadaviek v aktuálnej minúte ešte zostáva.
`X-RateLimit-Reset`	`integer`	Počet sekúnd do vynulovania počítadla.
`Retry-After`	`integer`	Iba v odpovedi `429`: počet sekúnd, ktoré musíte počkať, kým to skúsite znova.

Pri prekročení limitu je odpoveďou 429 s kódom rate_limited. Skôr ako to skúsite znova, počkajte čas uvedený v Retry-After.

Pokusy bez platného kľúča (bez kľúča, s nesprávnym alebo odvolaným kľúčom) sú obmedzené na 30 pokusov za minútu z každej IP adresy.

Ako neprekročiť limit

Používajte per_page až do 100, aby ste získali viac položiek s menším počtom požiadaviek.
Na sledovanie stavu TV stačí jedna požiadavka za minútu.
Pri veľkých úlohách rozložte požiadavky v čase a sledujte X-RateLimit-Remaining.

Hlavičky odpovede200

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 dosiahnutý429

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."
  }
}