Primeiros pasos

Límite de solicitudes

Cada usuario pode facer ata 120 solicitudes por minuto, sumando todas as súas chaves. O contador reiníciase ao comezo de cada minuto do reloxo.

As respostas a unha chave válida mostran o consumo nestas cabeceiras:

NomeTipoDescrición
X-RateLimit-LimitintegerSolicitudes permitidas por minuto.
X-RateLimit-RemainingintegerCantas quedan no minuto actual.
X-RateLimit-ResetintegerSegundos que faltan para que se reinicie o contador.
Retry-AfterintegerSó na resposta 429: segundos que debe agardar antes de tentalo de novo.

Se se supera o límite, a resposta é 429 co código rate_limited. Agarde o tempo indicado en Retry-After antes de tentalo de novo.

Os intentos sen unha chave válida (sen chave, cunha chave incorrecta ou revogada) limítanse a 30 por minuto para cada enderezo IP.

Para non chegar ao límite

  • Use per_page ata 100 para obter máis elementos con menos solicitudes.
  • Para seguir o estado das TV, abonda cunha consulta por minuto.
  • En tarefas grandes, reparta as solicitudes ao longo do tempo e vixíe X-RateLimit-Remaining.
Cabeceiras dunha 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í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."
  }
}