> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/rate-limit.md).

# Limite de requisições

A limitação de taxa define o número máximo de solicitações que um aplicativo pode fazer à API dentro de um período de tempo especificado. Esse mecanismo é crucial para manter a saúde geral e a confiabilidade dos serviços.

## Por que usamos limitação de taxa

A limitação de taxa atende a vários propósitos importantes:

### Estabilidade e desempenho da API

* Evita que um único cliente sobrecarregue nossos servidores com muitas solicitações
* Garante tempos de resposta consistentes para todos os usuários
* Protege os serviços de backend contra picos de tráfego
* Mantém padrões de carga previsíveis na infraestrutura

### Benefícios de segurança

* Defende contra ataques de força bruta
* Mitiga ataques de negação de serviço distribuída (DDoS)
* Reduz o impacto de aplicações cliente mal implementadas
* Limita os danos causados por credenciais de API comprometidas

### Alocação justa de recursos

* Garante acesso equitativo aos recursos compartilhados da API entre todos os clientes
* Evita que clientes agressivos prejudiquem o serviço para outros usuários
* Ajuda a priorizar o tráfego de acordo com as necessidades do negócio
* Incentiva padrões eficientes de uso da API

## Como a limitação de taxa funciona

Cada endpoint pode ter limites diferentes, definidos por:

* Janela de tempo (por minuto, hora ou dia)
* Tipo de aplicação (padrão ou empresarial)
* Tipo de operação (limites mais altos para operações de leitura, mais baixos para gravações)

Quando você excede seu limite de taxa, você recebe um `HTTP 429` (resposta "Muitas Requisições").

## Exemplo de resposta quando o limite de taxa é excedido

Quando você exceder o limite de taxa, receberá uma resposta como esta:

```json
{
  "message": "Muitas Requisições"
}
```

## Como lidar com erros 429 Too Many Requests

Quando você receber um `429` erro, implemente estas estratégias para lidar com ele de forma adequada:

### Implemente backoff exponencial com jitter

Backoff exponencial é uma estratégia de nova tentativa em que você aumenta progressivamente o tempo de espera entre as tentativas:

```javascript
// Exemplo de pseudocódigo de backoff exponencial com jitter
function fetchWithBackoff(url, maxRetries = 5) {
  let retries = 0;
  
  while (retries < maxRetries) {
    try {
      const response = await fetch(url);
      if (response.status !== 429) {
        return response; // Sucesso ou erro diferente
      }
      
      // Calcula o tempo de backoff com jitter
      const baseWaitTime = Math.pow(2, retries) * 1000; // 1s, 2s, 4s, 8s, 16s
      const jitter = Math.random() * 0.5 * baseWaitTime;
      const waitTime = baseWaitTime + jitter;
      
    
      console.log(`Limite de taxa atingido. Aguardando ${waitTime/1000} segundos antes da tentativa ${retries + 1}/${maxRetries}`);
      await sleep(waitTime);
      retries++;
      
    } catch (error) {
      // Trata outros erros
      throw error;
    }
  }
  
  throw new Error("Número máximo de tentativas atingido");
}
```

### Revise o comportamento da aplicação

* Audite seu código para identificar padrões ineficientes de uso da API
* Procure loops não intencionais ou chamadas de API redundantes
* Considere agrupar várias operações em uma única solicitação, quando aplicável
* Distribua suas solicitações de forma mais uniforme ao longo do tempo, em vez de enviá-las em rajadas

### Implemente cache

* Armazene em cache dados acessados com frequência e que mudam raramente
* Implemente estratégias adequadas de invalidação de cache
* Use tempos de expiração de cache apropriados com base na volatilidade dos dados
* Considere usar ETags ou cabeçalhos Last-Modified para solicitações condicionais


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/rate-limit.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
