Visão Geral
Este artigo explica o motivo pelo qual o sistema pode retornar o erro:
429 – “Current rate exceeds the maximum rate for this API”
Esse erro ocorre especificamente no sistema Argo e está relacionado ao limite de requisições (hits) permitido pela API. Não é causado pela nossa plataforma, trata-se de uma regra de proteção do próprio ambiente Argo.
O que são “Hits”?
No contexto do Argo (e de APIs em geral), hits são:
Solicitações enviadas ao servidor da API;
Cada consulta, listagem, busca ou verificação feita pelo sistema;
Requisições que contam para um limite definido pelo fornecedor.
Ou seja, cada chamada à API = 1 hit (ou mais, dependendo da operação).
Como o Argo controla os hits?
A Argo define um limite máximo de requisições que podem ser feitas dentro de um intervalo de tempo.
Esse mecanismo é chamado de rate limit e serve para:
Evitar sobrecarga no ambiente deles;
Garantir estabilidade e performance;
Distribuir o uso da API de forma equilibrada entre os clientes.
Esse controle é interno da Argo, não temos autonomia para alterar, aumentar ou ajustar esses limites.
O que a mensagem significa?
A mensagem:
“Current rate exceeds the maximum rate for this API”
significa que:
O sistema Argo detectou que o número de requisições/hits ultrapassou o limite permitido.
A API bloqueia novas chamadas temporariamente para evitar sobrecarga.
Qualquer operação realizada nesse período retorna o erro 429.
Isso pode ocorrer, por exemplo, quando:
Há muitas integrações consultando simultaneamente;
Algum processo executou chamadas em lote;
Existe um pico de tráfego em um curto intervalo de tempo.
Impacto
Quando o limite é excedido, o Argo interrompe temporariamente as respostas, resultando em:
Retorno de erro na etapa em execução (ex.: Registro 0 na etapa MEDZM4);
Falha em consultas ou verificações associadas;
Instabilidade momentânea nas rotinas dependentes da API Argo.
Como resolver
Como o limite é gerenciado exclusivamente pelo Argo, a resolução depende deles.
Recomendamos:
Aguardar alguns instantes, o Argo costuma liberar novos hits quando a janela de uso se renova.
Caso o problema persista, abrir chamado diretamente com o suporte Argo, solicitando:
Avaliação do consumo de hits;
Possível aumento do limite, se aplicável;
Verificação de anomalias no monitoramento interno.
Revisar, se necessário, fluxos que possam estar realizando chamadas excessivas.
Conclusão
O erro 429 – Rate Limit Exceeded indica que o Argo bloqueou temporariamente as requisições devido ao excesso de hits no período.
Trata-se de um comportamento nativo da API Argo, não sendo um erro do nosso sistema.
Para normalização, é necessário aguardar a liberação da janela ou acionar o suporte da Argo.
Para entender como visualizar e acompanhar o consumo de requisições, consulte o artigo sobre o Relatório de Requisições de API (Hits):
https://ligai.freshdesk.com/pt-BR/support/solutions/articles/67000701471-hits