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:
| Nome | Tipo | Descrición |
|---|---|---|
X-RateLimit-Limit | integer | Solicitudes permitidas por minuto. |
X-RateLimit-Remaining | integer | Cantas quedan no minuto actual. |
X-RateLimit-Reset | integer | Segundos que faltan para que se reinicie o contador. |
Retry-After | integer | Só 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_pageata 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: 42Lí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."
}
}