A API da CentralCart aplica limites de requisição (rate limit) para garantir
estabilidade e uso justo entre todas as lojas. As requisições são contadas
por rota e por origem (sua loja/credencial), em janelas fixas de 1 minuto.
Ou seja, cada endpoint tem o seu próprio contador e cada loja consome o seu
limite de forma independente.
Limites por operação
A regra geral segue o tipo da operação:
Cada rota possui um contador independente. Atingir o limite em um endpoint não
consome nem bloqueia os demais.
Quando o limite é excedido
Ao ultrapassar o limite, a API retorna o status 429 Too Many Requests e
recusa novas requisições até a janela reiniciar.
A resposta usa o mesmo envelope errors de todos os outros erros da API. Veja
Erros.
O tempo de espera é informado no header Retry-After (em segundos), não no corpo
da resposta.
Boas práticas
- Monitore o header
X-RateLimit-Remaining para se autorregular antes de
atingir o limite.
- Ao receber um
429, respeite o Retry-After e só tente novamente após o
tempo indicado.
- Implemente retentativa com backoff exponencial para lidar com picos de
tráfego.
- Evite polling agressivo: consulte dados em intervalos maiores ou use
webhooks para receber eventos em tempo real.
