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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fidelimax.com.br/outros/rate-limit-da-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
