Rate Limit da API
Conheça as limitações de fluxo da API e saiba como trabalhar com elas
A Fidelimax utiliza diversas camadas de proteção contra picos de tráfego de entrada para garantir estabilidade, segurança e performance em todos os ambientes integrados.
Nossa API conta com políticas automáticas de controle de tráfego (rate limits) que evitam abusos, sobrecarga dos servidores e asseguram respostas consistentes em tempo real.
Se forem enviadas muitas requisições em sequência, você poderá receber respostas de erro com o código de status 429 (Too Many Requests).
Limites de requisição
Os limites de uso da API variam conforme o plano contratado:
Plano Max: até 6 requisições por segundo
Plano Corp: limites superiores, ajustados conforme a faixa contratada
Ao ultrapassar o limite permitido, a API retornará automaticamente um dos seguintes códigos HTTP:
429 Too Many Requests — excesso temporário de chamadas.
403 Forbidden — bloqueio automático devido a comportamento fora do padrão esperado.
Bloqueios automáticos e liberação
A Fidelimax utiliza múltiplos mecanismos de análise de tráfego e ferramentas de segurança para monitorar continuamente o uso da API e detectar padrões que possam comprometer a estabilidade da plataforma.
Quando são identificados comportamentos anormais — como picos de requisições, acessos simultâneos excessivos, loops de chamadas ou uso fora das práticas esperadas — o sistema pode aplicar bloqueios automáticos temporários ou até mesmo adicionar o endereço de origem a listas de bloqueio (blacklists).
Esses bloqueios são gerenciados automaticamente e geralmente são removidos assim que o fluxo de requisições retorna aos limites normais.
Se o acesso permanecer bloqueado, o responsável pela integração pode abrir um chamado no canal oficial de suporte:
👉 https://www.fidelimax.com.br/ajuda/
Em determinadas situações, a Fidelimax poderá solicitar evidências técnicas (como logs ou amostras de requisições) para validar o desbloqueio e confirmar que o uso está em conformidade com as políticas da API.
Boas práticas de uso e monitoramento
Para garantir a estabilidade da integração e evitar interrupções automáticas, siga as práticas abaixo:
Respeite rigorosamente os limites de requisição do seu plano. Não envie tráfego acima do permitido. Configure mecanismos de throttling e controle de taxa (limites por segundo e janelas de contagem), tratando adequadamente as respostas 429/403 com retries exponenciais. Exceder os limites pode gerar bloqueios automáticos — a prevenção é sempre a melhor prática.
Evite verificações automáticas excessivas. Ferramentas de monitoramento que fazem checagens constantes apenas para confirmar se a API está “no ar” geram tráfego desnecessário e podem acionar bloqueios.
Acompanhe o status oficial da API em tempo real: 👉 https://status.fidelimax.com.br/ Nessa página você pode acompanhar a disponibilidade dos serviços — não é necessário criar uma página de status própria.
Uso do endpoint de status: Caso seja indispensável realizar verificações automáticas, utilize exclusivamente o endpoint:
/api/status-check
Requisições do tipo ping (ICMP) são bloqueadas por motivos de segurança e não devem ser utilizadas.
Intervalos de checagem: Se optar por monitorar via API, configure os intervalos de verificação para respeitar os limites estabelecidos. Verificações muito frequentes podem gerar bloqueios temporários, o que pode criar uma falsa impressão de indisponibilidade.
Eficiência de integração: Sempre que possível, armazene dados estáveis em cache e evite chamadas redundantes ou loops de requisições.
Solicitação de revisão
Se você acredita que o uso está dentro dos limites e ainda assim está recebendo erros de limite ou bloqueios, entre em contato com o suporte técnico: 👉 https://www.fidelimax.com.br/ajuda/
Nossa equipe analisará o caso e poderá ajustar os limites conforme a necessidade e o contrato.
Importante
O uso da API está sujeito às condições descritas em nossos Termos de Uso. O não cumprimento dessas diretrizes pode resultar em suspensão temporária ou definitiva do acesso à API.
Last updated
Was this helpful?