> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# rate limit

> o rate limiting limita o número de requisições que um cliente pode fazer em um curto período de tempo, evitando sobrecarregar a API.

## cabeçalhos de resposta

| cabeçalho               | descrição                                                       |
| ----------------------- | --------------------------------------------------------------- |
| `x-ratelimit-limit`     | número máximo de requisições permitidas por janela              |
| `x-ratelimit-remaining` | quantas requisições ainda podem ser feitas                      |
| `retry-after`           | tempo em segundos para aguardar (apenas quando limite excedido) |

## exemplo de comportamento

com a configuração de `ttl = 1 segundo` e `limit = 2`:

<Steps>
  <Step title="primeira requisição">
    bem-sucedida, retorna `x-ratelimit-remaining: 1`
  </Step>

  <Step title="segunda requisição">
    bem-sucedida, retorna `x-ratelimit-remaining: 0`
  </Step>

  <Step title="terceira requisição">
    se feita dentro do mesmo segundo, retorna `HTTP 429 (Too Many Requests)` com `retry-after: 1`
  </Step>
</Steps>

## boas práticas

* monitore o cabeçalho `x-ratelimit-remaining` para evitar atingir o limite
* implemente retry com backoff exponencial quando receber `HTTP 429`
* respeite o valor do cabeçalho `retry-after` antes de fazer novas requisições