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.
Updated about 2 months ago