Limites da API

Dúvidas frequentes sobre limites da API do Asaas

Recebendo erro 429 por um tempo curto pode ser requisições concorrentes? Entenda:

Requisições concorrentes são aquelas que são submetidas ao Asaas antes que a requisição anterior tenha sido respondida.

É possível realizar até 50 requisições concorrentes do tipo GET à nossa API. Caso esse limite seja ultrapassado, sua aplicação receberá como retorno o erro HTTP 429 Too Many Requests nas requisições.

Recebendo erro 429 por conta do Quota limit

Possuímos limite de cota de uso da API a cada 12 horas. O limite é de 25.000 requisições por conta independente do endpoint acessado. O contador inicia a partir do horário da primeira requisição e é incrementado pelas próximas 12h, quando o contador recomeça do zero e é contado novamente por 12h.

Se o limite for atingido ou ultrapassado, você receberá um erro HTTP 429 Too Many Requests.

Caso você realmente esteja ultrapassando essa cota com gerações de cobranças, por exemplo, pode ser aumentado o limite. Porém, se constatado que a conta está realizando polling, não podemos mexer no quota limit.

Recebendo erro 429 por conta do Rate Limit

Possuímos limites de solicitações em certos endpoints onde o abuso pode de certa forma comprometer o desempenho e o uso das APIs do Asaas. Medimos as requisições e podemos restringi-las quando a quantidade permitida é ultrapassada.

Você pode verificar o status nos cabeçalhos de resposta após uma requisição:

RateLimit-Limit: 100
RateLimit-Remaining: 50
RateLimit-Reset: 30

O cabeçalho RateLimit-Reset possui os segundos faltantes para resetar o limite.

Se o limite for atingido ou ultrapassado (RateLimit-Remaining: 0), você receberá um erro HTTP 429 Too Many Requests.

O Rate limit não é personalizável, precisando que você escale ele no seu sistema, conforme os retornos.