Aan de slag

Verzoeklimieten

Elke gebruiker kan maximaal 120 verzoeken per minuut doen, opgeteld over al zijn sleutels. De teller wordt aan het begin van elke klokminuut weer op nul gezet.

Antwoorden op verzoeken met een geldige sleutel tonen het verbruik in deze headers:

Naam	Type	Beschrijving
`X-RateLimit-Limit`	`integer`	Toegestane verzoeken per minuut.
`X-RateLimit-Remaining`	`integer`	Hoeveel er in de huidige minuut nog over zijn.
`X-RateLimit-Reset`	`integer`	Seconden totdat de teller weer op nul staat.
`Retry-After`	`integer`	Alleen in het antwoord `429`: aantal seconden dat u moet wachten voordat u het opnieuw probeert.

Boven de limiet is het antwoord 429 met de code rate_limited. Wacht de tijd uit Retry-After af voordat u het opnieuw probeert.

Pogingen zonder geldige sleutel (geen sleutel, een verkeerde of een ingetrokken sleutel) zijn beperkt tot 30 per minuut per IP-adres.

Zo blijft u onder de limiet

Gebruik per_page tot 100 om meer items met minder verzoeken op te halen.
Om de status van de TV's te volgen, is één verzoek per minuut genoeg.
Spreid bij grote taken de verzoeken over de tijd en houd X-RateLimit-Remaining in de gaten.

Headers van een antwoord200

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

Limiet bereikt429

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