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

# Limites de requisição

> Trate limites da API v1 sem presumir cotas fixas.

A API v1 aplica limites a todas as operações. Não fixe uma única cota no
código para todos os endpoints. Use a resposta de cada requisição.

## Respostas de limite

Quando uma requisição excede um limite, a API retorna `429`:

```json theme={null}
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}
```

A resposta inclui `Retry-After` como um número inteiro de segundos. Aguarde
pelo menos esse período antes de tentar novamente.

```text theme={null}
Retry-After: 30
```

Não repita um `429` imediatamente nem execute novas tentativas simultâneas
para o mesmo trabalho.

## Indisponibilidade do limitador

Se o limitador não conseguir tomar uma decisão, a API bloqueia a requisição
e retorna `503` com `rate_limiter_unavailable`. Essa resposta não inclui
`Retry-After`, pois não representa uma recusa por cota.

Trate os dois casos separadamente nos registros e na lógica de novas
tentativas:

* `429 rate_limited` significa que a requisição excedeu um limite.
* `503 rate_limiter_unavailable` significa que o limitador estava
  indisponível.

Consulte [Erros](/pt-BR/guides/errors) para conhecer o formato comum dos erros.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.