Limites de Taxa de Chamada da API
Limites da API
Rate limit
Limitamos o uso da API a fim de evitar possíveis abusos na quantidade de requisições aos nossos servidores. Esta é uma das medidas tomadas para garantir o bom funcionamento do sistema e evitar processamentos exaustivos e desnecessários.
A limitação da quantidade de requisições da API está diretamente vinculada à quantidade de usuários ativos para cada conta, seguindo a seguinte lógica:
- Cada usuário ativo dá direito à conta a fazer 12 requisições por minuto.
- Ex: Se uma conta possui 10 usuários ativos, então esta conta pode realizar um total de 120 requisições por minuto.
- Caso seja ultrapassada a quantidade de requisições por minuto da conta, a próxima requisição retornará uma resposta com o erro
HTTP 429 Too Many Requests.
Para que seja possível verificar a quantidade de requisições que ainda podem ser feitas, todas as requisições realizadas no sistema retornam os seguintes cabeçalhos (headers):
- X-Rate-Limit: indica a quantidade máxima de requisições que a conta pode realizar.
- X-Rate-Limit-Remaining: indica a quantidade de requisições que ainda podem ser feitas no minuto atual.
- X-Rate-Limit-Reset: indica o tempo restante, em segundos, até o rate-limit ser resetado.
