Aloitus

Pyyntörajoitus

Jokainen käyttäjä voi tehdä enintään 120 pyyntöä minuutissa kaikilla avaimillaan yhteensä. Laskuri nollautuu jokaisen kellominuutin alussa.

Kelvollisella avaimella tehtyjen pyyntöjen vastaukset näyttävät käytön näissä otsakkeissa:

Nimi	Tyyppi	Kuvaus
`X-RateLimit-Limit`	`integer`	Sallittujen pyyntöjen määrä minuutissa.
`X-RateLimit-Remaining`	`integer`	Kuinka monta pyyntöä on jäljellä kuluvalla minuutilla.
`X-RateLimit-Reset`	`integer`	Sekuntien määrä laskurin nollautumiseen.
`Retry-After`	`integer`	Vain vastauksessa `429`: kuinka monta sekuntia sinun on odotettava ennen uutta yritystä.

Kun raja ylittyy, vastaus on 429 ja virhekoodi rate_limited. Odota otsakkeen Retry-After ilmoittama aika ennen uutta yritystä.

Pyynnöt ilman kelvollista avainta (avain puuttuu, on väärä tai mitätöity) on rajoitettu 30 pyyntöön minuutissa IP-osoitetta kohden.

Näin pysyt rajan alla

Käytä parametria per_page (enintään 100), niin saat enemmän kohteita vähemmillä pyynnöillä.
TV:iden tilan seurantaan riittää yksi pyyntö minuutissa.
Jaa suurissa tehtävissä pyynnöt pidemmälle ajalle ja seuraa otsaketta X-RateLimit-Remaining.

Vastauksen otsakkeet200

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

Raja saavutettu429

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