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:

NombreTipoDescripción
X-RateLimit-LimitintegerSolicitudes permitidas por minuto.
X-RateLimit-RemainingintegerCuántas quedan en el minuto actual.
X-RateLimit-ResetintegerSegundos que faltan para que se reinicie el contador.
Retry-AfterintegerSolo en la respuesta 429: segundos que debe esperar antes de intentarlo nuevamente.

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

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, basta con una consulta por minuto.
  • En tareas grandes, distribuya las solicitudes a lo largo del tiempo y esté al pendiente de 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."
  }
}