Limites de requisição

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:

Operação	Limite
Leitura (`GET`)	120 req/min
Escrita (`POST`, `PATCH`, `DELETE`)	30 req/min

Cada rota possui um contador independente. Atingir o limite em um endpoint não consome nem bloqueia os demais.

Headers de controle

Toda resposta inclui headers que permitem acompanhar o consumo em tempo real:

Header	Descrição
`X-RateLimit-Limit`	Número máximo de requisições permitidas na janela atual.
`X-RateLimit-Remaining`	Quantas requisições ainda restam na janela atual.

Quando o limite é atingido, a resposta de erro também inclui:

Header	Descrição
`Retry-After`	Tempo, em segundos, até a janela reiniciar e novas requisições serem aceitas.

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.

{
  "errors": [
    {
      "message": "Resource rate limit reached.",
      "code": "RATE_LIMIT_REACHED"
    }
  ]
}

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.

Documentação da API

Endpoints de aplicação

Storefront API (Public)

Limites de requisição

Limites por operação

Headers de controle

Quando o limite é excedido

Boas práticas

​Limites por operação

​Headers de controle

​Quando o limite é excedido

​Boas práticas

Limites por operação

Headers de controle

Quando o limite é excedido

Boas práticas