Kom godt i gang

Grænser for forespørgsler

Hver bruger kan sende op til 120 forespørgsler pr. minut samlet for alle sine nøgler. Tælleren nulstilles ved starten af hvert minut på uret.

Svar på forespørgsler med en gyldig nøgle viser forbruget i disse headere:

Navn	Type	Beskrivelse
`X-RateLimit-Limit`	`integer`	Tilladte forespørgsler pr. minut.
`X-RateLimit-Remaining`	`integer`	Hvor mange der er tilbage i det aktuelle minut.
`X-RateLimit-Reset`	`integer`	Sekunder, indtil tælleren nulstilles.
`Retry-After`	`integer`	Kun i svaret `429`: antal sekunder, du skal vente, før du prøver igen.

Over grænsen er svaret 429 med koden rate_limited. Vent den tid, der står i Retry-After, før du prøver igen.

Forsøg uden en gyldig nøgle (ingen nøgle, forkert nøgle eller tilbagekaldt nøgle) er begrænset til 30 pr. minut for hver IP-adresse.

Sådan holder du dig under grænsen

Brug per_page op til 100 for at hente flere elementer med færre forespørgsler.
Til at følge TV'ernes status er én forespørgsel pr. minut nok.
Ved store opgaver bør du fordele forespørgslerne over tid og holde øje med 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

Grænsen er nået429

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