Skip to main content

​
cabeçalhos de resposta

cabeçalhodescrição
x-ratelimit-limitnúmero máximo de requisições permitidas por janela
x-ratelimit-remainingquantas requisições ainda podem ser feitas
retry-aftertempo em segundos para aguardar (apenas quando limite excedido)

​
exemplo de comportamento

com a configuração de ttl = 1 segundo e limit = 2:
1

primeira requisição

bem-sucedida, retorna x-ratelimit-remaining: 1
2

segunda requisição

bem-sucedida, retorna x-ratelimit-remaining: 0
3

terceira requisição

se feita dentro do mesmo segundo, retorna HTTP 429 (Too Many Requests) com retry-after: 1

​
boas práticas

  • monitore o cabeçalho x-ratelimit-remaining para evitar atingir o limite
  • implemente retry com backoff exponencial quando receber HTTP 429
  • respeite o valor do cabeçalho retry-after antes de fazer novas requisições