Clickfin

Referência da API
Portal oficial

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çalhoSignificado
X-RateLimit-LimitRequisições permitidas na janela da chave.
X-RateLimit-RemainingRequisições restantes na janela atual.
X-RateLimit-ResetFim da janela, em segundos desde a época Unix.
Retry-AfterSó no 429: segundos até poder tentar de novo.

Ao receber 429

  • Espere os segundos de Retry-After antes da próxima chamada; não repita em laço.
  • Para erros 503 e 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-Key e 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.