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

# Límites de solicitudes

> Gestiona los límites de la API v1 sin asumir cuotas fijas.

La API v1 aplica límites a todas las operaciones. No fijes una sola cuota en
el código para todos los endpoints. Usa la respuesta de cada solicitud.

## Respuestas por exceso de solicitudes

Cuando una solicitud supera un límite, la API devuelve `429`:

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

La respuesta incluye `Retry-After` como un número entero de segundos. Espera
al menos ese tiempo antes del siguiente intento.

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

No reintentes un `429` de inmediato ni ejecutes reintentos simultáneos para la
misma operación.

## Interrupciones del limitador

Si el limitador no puede tomar una decisión, la API rechaza la solicitud de
forma segura con `503` y `rate_limiter_unavailable`. Esta respuesta no incluye
`Retry-After` porque no indica que se haya superado una cuota.

Separa los dos casos en los registros y en la lógica de reintento:

* `429 rate_limited` significa que la solicitud superó un límite.
* `503 rate_limiter_unavailable` significa que el limitador no estaba
  disponible.

Consulta [Errores](/es/guides/errors) para conocer el formato compartido de
los errores.


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