Limites de requisição
Os limites protegem a sua loja e a de todo mundo. Uma integração normal fica bem abaixo deles.
| Limite | Valor |
|---|---|
| Por chave | 120 requisições por minuto |
| Por endereço IP | 600 requisições por minuto (somando todas as chaves que saem do mesmo servidor) |
| Estoque por envio | 5.000 itens; até 10.000 livres por opção |
| Itens por página | até 100 |
| Chaves e webhooks | 20 chaves ativas e 10 webhooks por loja |
Passou do limite, a resposta é 429 com o cabeçalho Retry-After (em segundos). Espere esse tempo e tente de novo.
Para gastar menos
- Use os webhooks para saber quando algo muda, em vez de consultar a API a cada poucos segundos.
- Filtre as listas (ex.:
?status=paid&paid_from=2026-11-01) e useper_page=100. - Mande o estoque em lote, num envio só.