Skip to main content

​
Visão geral

A API Cakto aplica limites de taxa para proteger a plataforma. Ao ultrapassar um limite, a resposta é 429 Too Many Requests.

​
Limites por endpoint

Os dois limites de Criar Cobrança valem ao mesmo tempo. Uma integração que concentra o tráfego num único IP atinge o teto de 60/min mesmo usando vários tokens.
Estes são os valores padrão. Se sua operação tem volume acima disso, fale com o suporte antes de escalar.

​
Resposta ao exceder

A resposta inclui o header Retry-After com o número de segundos a aguardar.

​
Como reagir

Ao receber 429, aguarde o tempo indicado no header Retry-After antes de tentar de novo. Reenviar imediatamente só consome o limite outra vez.
Se o header não estiver disponível, aumente o intervalo a cada tentativa (por exemplo 1s, 2s, 4s, 8s) em vez de repetir em intervalo fixo.
Ao repetir uma cobrança que tomou 429, mantenha o mesmo X-Idempotency-Key. Assim, se a requisição original tiver sido processada, você recebe a resposta original em vez de uma cobrança duplicada. Veja Idempotência.
Ao processar filas grandes, espace as requisições ao longo do minuto em vez de dispará-las todas de uma vez.

​
Próximos passos

Idempotência

Repita requisições sem duplicar cobranças

Erros

Formato das respostas de erro da API