Limites
Limites de requisição e de chaves
Cada chave pode fazer 120 requisições por minuto, numa janela fixa de 60 segundos contada no servidor (vale para todas as instâncias da API ao mesmo tempo). Acima disso, a resposta é 429 RATE_LIMIT.EXCEEDED.
Cabeçalhos
Toda resposta em que a chave foi reconhecida, com sucesso ou erro (inclusive 403 API_KEY.SCOPE_REQUIRED e o 429 da chave), traz os cabeçalhos abaixo. Eles descrevem só o limite da chave e não vêm em 401, 503 nem no 429 por IP.
| Cabeçalho | Significado |
|---|---|
X-RateLimit-Limit | Requisições permitidas na janela da chave. |
X-RateLimit-Remaining | Requisições restantes na janela atual. |
X-RateLimit-Reset | Fim da janela, em segundos desde a época Unix. |
Retry-After | Só no 429: segundos até poder tentar de novo. |
Ao receber 429
- Espere os segundos de
Retry-Afterantes da próxima chamada; não repita em laço. - Para erros
503e falhas de rede, use backoff exponencial com variação aleatória (por exemplo 1, 2, 4, 8 segundos, até 5 tentativas). - Escritas que podem ser repetidas com segurança: emissão de boleto e de NFS-e com o mesmo
Idempotency-Keye o mesmo corpo. - Distribua cargas grandes (importações, sincronizações) ao longo do tempo em vez de disparar tudo de uma vez.
{ "status": "error", "category": "RATE_LIMIT.EXCEEDED", "message": "Too many requests for this API key. Try again later."}Limite por IP
Além do limite da chave, chamadas com chave de um mesmo IP têm um teto de 600 requisições em 10 minutos, que protege contra tentativas com chaves inválidas. Também responde 429 RATE_LIMIT.EXCEEDED, só com Retry-After.
Chaves por licença
Cada licença tem até 5 chaves ativas. Durante uma rotação, a chave nova não conta no limite enquanto a anterior está na sobreposição. Precisa de mais chaves ou de um limite de requisições maior? Fale com o suporte da ClickFin.