Limites e planos
A API e os webhooks estão em todos os planos, com limites que crescem com o plano. Os limites protegem a sua conta e a plataforma: sob pressão, a API responde 429 ou 503 antes de o app ficar lento para quem está usando.
| Limite | Bancada | Oficina | Farm |
|---|---|---|---|
| API e webhooks | Sim | Sim | Sim |
| Chaves de API ativas | 2 | 3 | 10 |
| Endpoints de webhook | 1 | 3 | 10 |
| Leituras por minuto (conta) | 30 | 60 | 180 |
| Escritas por minuto (conta) | 10 | 20 | 60 |
| Chamadas por mês | 50.000 | 150.000 | 750.000 |
| Rajada por chave | 5, repõe 1 por segundo | 10, repõe 2 por segundo | 20, repõe 5 por segundo |
| Requisições simultâneas (chave / conta) | 2 / 3 | 3 / 3 | 3 / 3 |
| Entregas de webhook por hora | 300 | 1.000 | 5.000 |
Tetos iniciais.
Custo de cada chamada
| Operação | Custo | Classe |
|---|---|---|
GET de um recurso | 1 | leitura |
GET de lista com limite até 25 | 1 | leitura |
GET de lista com limite de 26 a 100, ou com 2 ou mais filtros | 3 | cara |
GET /produtos (o motor calcula o preço de cada produto) | 1 + 1 a cada 25 produtos | cara acima de 25 |
POST /estoque/movimentos | 2 | escrita |
POST /cotacoes e POST /pedidos-producao | 5 | escrita |
Resposta 304 ou repetição idempotente | 1 na rajada, 0 no mês | leitura |
Cabeçalhos
RateLimit-Policy: "rajada";q=10;w=1, "minuto";q=60;w=60, "mes";q=150000;w=2592000
RateLimit: "minuto";r=42;t=18
Retry-After: 18RateLimit-Policy: os limites desta chave (q= quantidade,w= janela em segundos).RateLimit: o limite mais perto de estourar (r= restante,t= segundos até repor).Retry-After: no429e no503, quantos segundos esperar.
Recebeu 429?
- Espere
Retry-Aftere reduza o ritmo; não repita em laço. - Use webhooks em vez de consultar de minuto em minuto.
- Use
If-None-Match:304não gasta a cota do mês. - Chave com muitas recusas seguidas por limite é suspensa por 15 minutos, com e-mail ao dono.