Skip to main content
As APIs da DeliveryVip limitam o volume de requisições para manter a plataforma estável para todas as lojas. Acima do limite, a API responde 429 Too Many Requests em vez de processar a chamada.

Limites

Além do limite geral, o polling de eventos tem uma cadência própria: uma chamada a cada 30 segundos, exceto para drenar uma fila acumulada. Veja Consultar novos pedidos.

Ao receber 429

1

Pare de enviar

Não repita a chamada imediatamente: cada tentativa dentro da janela conta para o limite.
2

Espere

Se a resposta trouxer o header Retry-After, espere o tempo indicado. Sem ele, espere ao menos a janela de 10 segundos.
3

Repita com backoff

Tente de novo dobrando a espera a cada 429 seguido (10 s, 20 s, 40 s…), com um teto.
Trate o 429 pelo status HTTP. O corpo pode não seguir o formato padrão de erros e pode nem ser JSON.

Boas práticas

Reaproveite o token. Ele vale 24 horas. Pedir um token por chamada dobra o número de requisições sem ganho nenhum.
Prefira webhook a polling agressivo. O webhook entrega cada evento na hora, sem consumir o seu limite.
Use cache para o que muda pouco. Catálogo, dados da loja e horários de funcionamento não precisam ser consultados a cada pedido.
Espalhe as rotinas em lote. Sincronizações de muitas lojas devem ser distribuídas no tempo, não disparadas todas no mesmo segundo.