Primeiros passos

Limite de requisições

Cada usuário pode fazer até 120 requisições por minuto, somando todas as chaves dele. O contador zera a cada minuto do relógio.

As respostas para uma chave válida mostram o consumo nestes cabeçalhos:

Nome	Tipo	Descrição
`X-RateLimit-Limit`	`integer`	Requisições permitidas por minuto.
`X-RateLimit-Remaining`	`integer`	Quantas ainda restam no minuto atual.
`X-RateLimit-Reset`	`integer`	Segundos até o contador zerar.
`Retry-After`	`integer`	Só na resposta `429`: segundos que você deve esperar antes de tentar de novo.

Acima do limite, a resposta é 429 com o código rate_limited. Espere o tempo de Retry-After antes de tentar de novo.

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

Para não chegar ao limite

Use per_page até 100 para buscar mais itens com menos requisições.
Para acompanhar o status das TVs, uma consulta por minuto é suficiente.
Em tarefas grandes, distribua as requisições 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."
  }
}