Primeros pasos

Límite de peticiones

Cada usuario puede hacer hasta 120 peticiones por minuto, sumando todas sus claves. El contador se pone a cero al empezar cada minuto del reloj.

Las respuestas a una clave válida indican el consumo en estas cabeceras:

Nombre	Tipo	Descripción
`X-RateLimit-Limit`	`integer`	Peticiones permitidas por minuto.
`X-RateLimit-Remaining`	`integer`	Cuántas quedan en el minuto actual.
`X-RateLimit-Reset`	`integer`	Segundos que faltan para que el contador se ponga a cero.
`Retry-After`	`integer`	Solo en la respuesta `429`: segundos que debe esperar antes de volver a intentarlo.

Si se supera el límite, la respuesta es 429 con el código rate_limited. Espere el tiempo indicado en Retry-After antes de volver a intentarlo.

Los intentos sin una clave válida (sin clave, con una clave incorrecta o revocada) se limitan a 30 por minuto por cada dirección IP.

Para no alcanzar el límite

Use per_page hasta 100 para obtener más elementos con menos peticiones.
Para seguir el estado de las TVs, basta con una consulta por minuto.
En tareas grandes, reparta las peticiones a lo largo del tiempo y vigile X-RateLimit-Remaining.

Cabeceras de una respuesta200

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ímite alcanzado429

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