Limites de requisições
Limites por plano
Cada espaço de trabalho tem um orçamento por minuto e uma janela de rajada: no máximo 2× a taxa média em qualquer intervalo de 10 segundos. O que acabar primeiro responde 429 rate_limited com Retry-After. O seu próprio uso do app nunca conta no orçamento da API.
| Plano | Por minuto | Burst | Incluídos / mês | Jobs simultâneos |
|---|---|---|---|---|
| Pro | 60 | 20 / 10 s | 4.000 | 2 |
| Business | 600 | 200 / 10 s | 12.000 | 5 |
| Enterprise | sob medida | sob medida | sob medida | sob medida |
Cabeçalhos de resposta
X-RateLimit-LimitRequisições permitidas por minuto para o espaço de trabalho.X-RateLimit-RemainingRequisições restantes no minuto atual.X-RateLimit-ResetSegundos até a janela de um minuto zerar (não é um horário Unix).Retry-AfterEm todo 429: segundos de espera antes de tentar de novo.X-Request-IdO id da requisição, também nos corpos de erro. Informe-o ao suporte.Idempotent-Replayedtrue quando a resposta é um replay de uma requisição anterior.Requisições mensais
Cada plano inclui um número de requisições por mês-calendário (UTC). O uso aparece em Settings → API ao lado da latência e da taxa de erro dos últimos 30 dias. Passar do limite hoje não é recusado; qualquer mudança será anunciada antes aqui e no changelog.
Trabalho pesado
As execuções em massa e as exportações ZIP rodam em segundo plano e dividem os trabalhos simultâneos do plano; os demais esperam em uma fila. Acompanhe-os por consulta ou com os webhooks bulk.completed e export.completed, em vez de consultar em um laço apertado.