Limite de requisições

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.