Limites de chamadas

Rascunho para revisão

Este conteúdo é um rascunho e está sujeito a revisão antes da publicação.

As APIs limitam a quantidade de chamadas por minuto.

• As APIs de negócio (Workflow e Cadastro) são limitadas por assinatura.
• A rota de token é limitada por IP.

Valores do ambiente de desenvolvimento

Nota

Os valores abaixo valem somente para o ambiente de desenvolvimento. Os limites de produção são a definir.

API	Limite
Workflow	10 chamadas por minuto, por assinatura
Cadastro	5 chamadas por minuto, por assinatura
Token (/auth/v1/token)	10 chamadas por minuto, por IP

Resposta 429

Ao exceder o limite, a API responde 429 com o header Retry-After, que informa em segundos quanto esperar até a próxima tentativa.

Exemplo de resposta

HTTP/1.1 429
Retry-After: 30
X-Request-Id: 00000000-0000-0000-0000-000000000000
Content-Type: application/problem+json

{
"title": "Too Many Requests",
"status": 429,
"requestId": "00000000-0000-0000-0000-000000000000"
}

Os valores acima são fictícios.

Como tratar

• Aguarde o número de segundos de Retry-After antes de repetir a chamada.
• Não repita a chamada imediatamente nem em laço apertado: isso só prolonga o bloqueio.
• Reaproveite o token enquanto for válido, em vez de pedir um novo a cada chamada, para não consumir o limite da rota de token. Veja Autenticação.

Veja também o formato dos erros em Erros.