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:
| Nome | Tipo | Descrizione |
|---|---|---|
X-RateLimit-Limit | integer | Richieste consentite al minuto. |
X-RateLimit-Remaining | integer | Richieste ancora disponibili nel minuto corrente. |
X-RateLimit-Reset | integer | Secondi mancanti all'azzeramento del contatore. |
Retry-After | integer | Solo 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_pagefino 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: 42Limite 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."
}
}