Primeros pasos

Límite de solicitudes

Cada usuario puede hacer hasta 120 solicitudes por minuto, sumando todas sus claves. El contador se reinicia al comienzo de cada minuto del reloj.

Las respuestas a una clave válida muestran el consumo en estos encabezados:

Nombre	Tipo	Descripción
`X-RateLimit-Limit`	`integer`	Solicitudes permitidas por minuto.
`X-RateLimit-Remaining`	`integer`	Cuántas quedan en el minuto actual.
`X-RateLimit-Reset`	`integer`	Segundos que faltan para que se reinicie el contador.
`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) están limitados a 30 por minuto para cada dirección IP.

Para no llegar al límite

Use per_page hasta 100 para obtener más elementos con menos solicitudes.
Para dar seguimiento al estado de las TVs, es suficiente una consulta por minuto.
En tareas grandes, distribuya las solicitudes a lo largo del tiempo y esté atento a X-RateLimit-Remaining.

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