# Rate Limit da API

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.<br>

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<br>

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/](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**

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.\ <br>
* **Acompanhe o status oficial da API em tempo real:**\
  👉 [https://status.fidelimax.com.br/<br>](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.\ <br>
* **Eficiência de integração:**\
  Sempre que possível, armazene dados estáveis em cache e evite requisições 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/](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](https://www.fidelimax.com.br/termos-de-uso/).\
O não cumprimento dessas diretrizes pode resultar em **suspensão temporária** **ou definitiva** do acesso à API.