Limites de requisições e cache

Quantas requisições você pode enviar, os cabeçalhos que informam isso e o que manter em cache.

120 requisições por minuto

Cada endereço pode enviar 120 requisições por minuto à API pública. A contagem recomeça no início de cada minuto do relógio; RateLimit-Reset diz quantos segundos faltam até lá.

Cabeçalhos que mostram onde você está

Toda resposta traz RateLimit-Limit, quantas requisições a janela permite; RateLimit-Remaining, quantas restam; e RateLimit-Reset, os segundos até a janela recomeçar.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Quando você passa do limite

Uma requisição acima do limite responde 429 rate_limited com um cabeçalho Retry-After em segundos. Aguarde esse tempo antes da próxima requisição; enviar mais nesse meio-tempo não encurta a espera.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Guarde uma cópia

Os dados do catálogo mudam no máximo algumas vezes por dia. Armazene as respostas que você usa e atualize-as periodicamente em vez de pedi-las de novo a cada visitante. Algumas respostas trazem um cabeçalho Cache-Control que informa por quanto tempo continuam atualizadas.