Skip to main content
A API v1 aplica limites a todas as operações. Não fixe uma única cota no código para todos os endpoints. Use a resposta de cada requisição.

​
Respostas de limite

Quando uma requisição excede um limite, a API retorna 429:
A resposta inclui Retry-After como um número inteiro de segundos. Aguarde pelo menos esse período antes de tentar novamente.
Não repita um 429 imediatamente nem execute novas tentativas simultâneas para o mesmo trabalho.

​
Indisponibilidade do limitador

Se o limitador não conseguir tomar uma decisão, a API bloqueia a requisição e retorna 503 com rate_limiter_unavailable. Essa resposta não inclui Retry-After, pois não representa uma recusa por cota. Trate os dois casos separadamente nos registros e na lógica de novas tentativas:
  • 429 rate_limited significa que a requisição excedeu um limite.
  • 503 rate_limiter_unavailable significa que o limitador estava indisponível.
Consulte Erros para conhecer o formato comum dos erros.