Limites de requisições

(Rate Limit)

Para garantir a estabilidade e o bom desempenho da API, todos os endpoints possuem limite de requisições. Esse controle evita sobrecarga nos servidores e assegura uma experiência consistente para todos os desenvolvedores e sistemas integrados.

Por que existe um limite?

Sem um controle de taxa, um número excessivo de requisições simultâneas poderia:

  • Comprometer a performance da API;
  • Causar lentidão ou interrupções temporárias no serviço;
  • Impactar negativamente outros usuários que utilizam a mesma infraestrutura.

O rate limit serve, portanto, para manter a disponibilidade, segurança e confiabilidade do ambiente.

Limite atual

Cada conta possui um limite de 10 requisições por minuto, salvo no endpoint /api/integrations/channel/order/{id} que é de 5 requisições por minuto, válido para todos os endpoints da API.

Isso significa que, independentemente do tipo de requisição (GET, POST, PUT, DELETE), o total combinado não deve ultrapassar 10 ou 5 chamadas dentro de 60 segundos.

Implemente um mecanismo de retry com backoff exponencial para lidar com respostas de limite excedido (HTTP 429 Too Many Requests).