Primeiros passos

Limite de pedidos

Cada utilizador pode fazer até 120 pedidos por minuto, no conjunto de todas as suas chaves. O contador é reposto a zero no início de cada minuto do relógio.

As respostas a uma chave válida mostram a utilização nestes cabeçalhos:

Nome	Tipo	Descrição
`X-RateLimit-Limit`	`integer`	Pedidos permitidos por minuto.
`X-RateLimit-Remaining`	`integer`	Quantos pedidos restam no minuto atual.
`X-RateLimit-Reset`	`integer`	Segundos até o contador ser reposto a zero.
`Retry-After`	`integer`	Apenas na resposta `429`: segundos que deve aguardar antes de tentar novamente.

Acima do limite, a resposta é 429 com o código rate_limited. Aguarde o tempo indicado em Retry-After antes de tentar novamente.

As tentativas sem uma chave válida (sem chave, com uma chave errada ou revogada) estão limitadas a 30 por minuto para cada endereço IP.

Para não atingir o limite

Utilize per_page até 100 para obter mais itens com menos pedidos.
Para acompanhar o estado das TVs, basta uma consulta por minuto.
Em tarefas grandes, distribua os pedidos ao longo do tempo e acompanhe o X-RateLimit-Remaining.

Cabeçalhos de uma 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

Limite atingido429

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