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 emissão de token valem ao mesmo tempo, e são contados por IP — não por credencial. No momento da emissão a credencial ainda não foi validada, então o IP é o único identificador disponível; integrações que saem pelo mesmo endereço dividem esse teto.Na prática ele quase nunca é atingido: com validade de 10 horas, quem guarda o token não chega perto de 20 emissões por minuto. Encostar nesse limite costuma significar que a integração está pedindo um token novo a cada chamada — veja Autenticação.
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.
Solicitar Saque tem o limite mais baixo da API — 2 por hora — e é intencional. Não é capacidade: é contenção. Uma chave de API vazada com withdrawals_write consegue, no pior caso, dois saques por hora até você revogá-la, em vez de esvaziar a conta. Agrupe os saques em vez de pedir em valores pequenos.
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.
POST /public_api/token/ responde em formato OAuth, igual aos demais erros daquele endpoint:
O header Retry-After acompanha os dois formatos.

​
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