Limites de taxa
Limites de proteção são aplicados por organização isolada. Exceder um limite de requisições ou de criação de execuções retorna HTTP 429 com um intervalo de espera `Retry-After` em segundos.
Os limites são protetivos, por organização e declarados de antemão: 120 requisições de API por minuto, 10 criações de execução por minuto, mais a franquia mensal por plano. Exceder um deles retorna HTTP 429 com um intervalo Retry-After em segundos.
Esta página é o contrato — os números, o formato da resposta e o padrão de polling que mantém integrações dentro dele.
Os tetos são dimensionados para que uma integração bem-comportada nunca os encontre: consulta de status a cerca de uma requisição a cada cinco segundos e criação de execuções no ritmo do seu pipeline ficam muito abaixo de ambos.
Limites por plano
- Todos os planos: até 120 requisições de API/minuto por organização isolada.
- Criação de execuções: até 10 novas execuções/minuto por organização isolada, além da franquia mensal.
- Execuções mensais: Free 150, Starter 200, Pro 500; Enterprise é definido em contrato.
Limite de requisições e limite de criação de execuções são orçamentos separados: uma rajada de consultas de status gasta o primeiro, uma rajada de novos scans gasta o segundo, e a franquia mensal (Free 150, Starter 200, Pro 500; Enterprise em contrato) limita o total.
Os tetos por minuto se aplicam igualmente a todos os planos; o plano limita quanto você pode executar em um mês, não a velocidade de resposta da API. Upgrade muda a franquia, nunca o ritmo.
Boa prática
- Use `Retry-After` como intervalo mínimo de espera antes de tentar de novo.
- Polling em batch: 1 request a cada 5 segundos é suficiente para status de execução.
- Consulte o estado da execução até que a entrega por webhook por organização esteja disponível.
Trate o Retry-After como piso, não sugestão, e consulte o status em cerca de uma requisição a cada cinco segundos. Enquanto a entrega por webhook por organização não está disponível, polling é a forma suportada de acompanhar o fim de uma execução.
Quando chegar um 429, trate o Retry-After como o que ele é — o contrato: espere aqueles segundos, retome e alongue seu intervalo de consulta se eles continuarem acontecendo. Um 429 é normal; uma sequência deles significa que o cliente está ultrapassando o orçamento declarado.