Primers passos

Límit de sol·licituds

Cada usuari pot fer fins a 120 sol·licituds per minut, sumant totes les seves claus. El comptador es reinicia a l'inici de cada minut del rellotge.

Les respostes a una clau vàlida mostren el consum en aquestes capçaleres:

Nom	Tipus	Descripció
`X-RateLimit-Limit`	`integer`	Sol·licituds permeses per minut.
`X-RateLimit-Remaining`	`integer`	Quantes en queden en el minut actual.
`X-RateLimit-Reset`	`integer`	Segons que falten perquè es reiniciï el comptador.
`Retry-After`	`integer`	Només a la resposta `429`: segons que heu d'esperar abans de tornar-ho a provar.

Si se supera el límit, la resposta és 429 amb el codi rate_limited. Espereu el temps indicat a Retry-After abans de tornar-ho a provar.

Els intents sense una clau vàlida (sense clau, amb una clau incorrecta o revocada) es limiten a 30 per minut per a cada adreça IP.

Per no arribar al límit

Utilitzeu per_page fins a 100 per obtenir més elements amb menys sol·licituds.
Per seguir l'estat de les TV, n'hi ha prou amb una consulta per minut.
En tasques grans, repartiu les sol·licituds al llarg del temps i vigileu X-RateLimit-Remaining.

Capçaleres d'una resposta200

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

Límit assolit429

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