# Limite de Requisições Excedido

Muitas requisições foram enviadas na janela de tempo atual. A API impõe limites de requisições para garantir uso justo e estabilidade da plataforma.

**HTTP Status:** `429 Too Many Requests`

## Códigos de Erro

| Código | Descrição |
|  --- | --- |
| `rate_limit_exceeded` | O limite de requisições foi excedido |


## Exemplo de Resposta

```json
{
  "type": "https://docs.dinie.com/errors/rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Try again in 30 seconds.",
  "code": "rate_limit_exceeded"
}
```

## Headers de Rate Limit

Toda resposta da API inclui estes headers:

| Header | Descrição |
|  --- | --- |
| `X-RateLimit-Limit` | Número máximo de requisições permitidas na janela atual |
| `X-RateLimit-Remaining` | Requisições restantes na janela atual |
| `X-RateLimit-Reset` | Timestamp Unix de quando a janela será reiniciada |


## Como Resolver

- Leia o header `X-RateLimit-Reset` e aguarde até esse momento antes de tentar novamente.
- Implemente backoff exponencial na lógica de retentativa.
- Agrupe operações quando possível para reduzir o número de requisições individuais.
- Monitore o header `X-RateLimit-Remaining` para reduzir o ritmo proativamente antes de atingir o limite.


## Veja Também

- [Guia de Tratamento de Erros](/apis/concepts/errors) -- Padrões completos de tratamento de erros e exemplos de código