Primeros pasos

Límite de solicitudes

Cada usuario puede hacer hasta 120 solicitudes por minuto, sumando todas sus claves. El contador vuelve a cero 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 el contador vuelva a cero.
`Retry-After`	`integer`	Solo en la respuesta `429`: segundos que tenés que esperar antes de volver a intentar.

Si superás el límite, la respuesta es 429 con el código rate_limited. Esperá el tiempo indicado en Retry-After antes de volver a intentar.

Los intentos sin una clave válida (sin clave, con una clave incorrecta o revocada) tienen un límite de 30 por minuto para cada dirección IP.

Para no llegar al límite

Usá per_page hasta 100 para traer más elementos con menos solicitudes.
Para seguir el estado de las TVs, alcanza con una consulta por minuto.
En tareas grandes, repartí las solicitudes a lo largo del tiempo y prestá atención 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."
  }
}