Kom i gang

Grenser for forespørsler

Hver bruker kan sende opptil 120 forespørsler per minutt, samlet for alle nøklene sine. Telleren nullstilles ved starten av hvert klokkeminutt.

Svar på forespørsler med en gyldig nøkkel viser forbruket i disse headerne:

Navn	Type	Beskrivelse
`X-RateLimit-Limit`	`integer`	Tillatte forespørsler per minutt.
`X-RateLimit-Remaining`	`integer`	Hvor mange som gjenstår i inneværende minutt.
`X-RateLimit-Reset`	`integer`	Sekunder til telleren nullstilles.
`Retry-After`	`integer`	Bare i svaret `429`: antall sekunder du må vente før du prøver igjen.

Over grensen er svaret 429 med koden rate_limited. Vent tiden som er oppgitt i Retry-After, før du prøver igjen.

Forsøk uten en gyldig nøkkel (ingen nøkkel, feil nøkkel eller tilbakekalt nøkkel) er begrenset til 30 per minutt for hver IP-adresse.

Slik holder du deg under grensen

Bruk per_page opptil 100 for å hente flere elementer med færre forespørsler.
For å følge med på statusen til TV-ene holder det med én forespørsel per minutt.
Ved store jobber bør du spre forespørslene over tid og følge med på X-RateLimit-Remaining.

Headere i et svar200

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

Grensen er nådd429

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