Per iniziare

Limite di richieste

Ogni utente può effettuare fino a 120 richieste al minuto, sommando tutte le sue chiavi. Il contatore si azzera all'inizio di ogni minuto.

Le risposte a una chiave valida mostrano il consumo in queste intestazioni:

NomeTipoDescrizione
X-RateLimit-LimitintegerRichieste consentite al minuto.
X-RateLimit-RemainingintegerRichieste ancora disponibili nel minuto corrente.
X-RateLimit-ResetintegerSecondi mancanti all'azzeramento del contatore.
Retry-AfterintegerSolo nella risposta 429: secondi da attendere prima di riprovare.

Oltre il limite, la risposta è 429 con il codice rate_limited. Attendi il tempo indicato in Retry-After prima di riprovare.

I tentativi senza una chiave valida (senza chiave, con una chiave errata o revocata) sono limitati a 30 al minuto per ogni indirizzo IP.

Per non raggiungere il limite

  • Usa per_page fino a 100 per ottenere più elementi con meno richieste.
  • Per monitorare lo stato delle TV basta una richiesta al minuto.
  • Per le operazioni più pesanti, distribuisci le richieste nel tempo e tieni d'occhio X-RateLimit-Remaining.
Intestazioni di una risposta200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
Limite raggiunto429
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."
  }
}