Első lépések

Kéréskorlát

Minden felhasználó legfeljebb percenként 120 kérést küldhet, az összes kulcsát együttvéve. A számláló minden egész perc elején nullázódik.

Az érvényes kulccsal küldött kérésekre adott válaszok ezekben a fejlécekben mutatják a felhasználást:

Név	Típus	Leírás
`X-RateLimit-Limit`	`integer`	Percenként engedélyezett kérések száma.
`X-RateLimit-Remaining`	`integer`	Hány kérés maradt még az aktuális percben.
`X-RateLimit-Reset`	`integer`	Hány másodperc van hátra a számláló nullázásáig.
`Retry-After`	`integer`	Csak `429` állapotkódú válaszban: hány másodpercet kell várnia, mielőtt újra próbálkozik.

A korlát túllépésekor a válasz állapotkódja 429, hibakódja rate_limited. Mielőtt újra próbálkozik, várja ki a Retry-After fejlécben megadott időt.

Az érvényes kulcs nélküli próbálkozások (kulcs nélkül, hibás vagy visszavont kulccsal) IP-címenként percenként 30 kérésre korlátozódnak.

Hogy ne érje el a korlátot

Használja a per_page paramétert (legfeljebb 100), hogy kevesebb kéréssel több elemet kérjen le.
A TV-k állapotának követéséhez percenként egy lekérdezés is elég.
Nagy feladatoknál ossza el időben a kéréseket, és figyelje az X-RateLimit-Remaining fejlécet.

Egy válasz fejlécei200

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

Korlát elérve429

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