## Qué restringe el límite de solicitudes

El límite de solicitudes controla con qué frecuencia su aplicación puede llamar a la
API, es decir, el número de solicitudes, no el número de mensajes enviados. El
propio portal lo indica en los ajustes:

> Al establecer este límite, se restringe la cantidad de solicitudes de API, no la
> cantidad de mensajes enviados. Cuando se alcanza el límite, la API devuelve el
> código HTTP `429 Too Many Requests` y no se aceptan los mensajes.

Una sola solicitud puede contener cientos de mensajes, por lo que este límite protege
algo distinto de los [límites de mensajes de la API](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/limites-de-la-api/): controla
el ritmo de sus llamadas, no el volumen que envía.

> [!IMPORTANT]
> Cuando se agota el límite, la API rechaza **toda la solicitud**. Los mensajes que contiene
> no se guardan en ningún sitio ni se envían más tarde, a diferencia del límite de mensajes,
> donde los mensajes que superan el límite se tratan según la acción configurada para ese caso.

## Dónde encontrar el límite

1. En el menú del portal, haga clic en `Módulos y APIs`
2. En `Mis APIs y módulos`, haga clic en la tarjeta de su aplicación
3. Permanezca en la pestaña `Ajustes` y desplácese hasta la parte `Límites de API`

La tarjeta `Límites de solicitud de API` muestra los valores en dos filas:
`Máximo de solicitudes por minuto` y `Máximo de solicitudes por segundo`. Mientras
no haya nada configurado, muestra `No tienes configuración.` y un botón `Configurar`.

![Tarjeta Límites de solicitud de API en el detalle de la aplicación](docs:api-request-limits/request-limit-card_en)

## Cómo configurar el límite

El botón `Configurar` (o `Editar`, si ya tiene un límite) abre la ventana `Límites de
solicitud de API` con dos opciones independientes:

| Opción | Qué configura |
|:--|:--|
| `Activar límite de solicitudes de API por minuto` | Cuántas solicitudes puede enviar la aplicación en un minuto |
| `Activar límite de solicitudes de API por segundo` | Cuántas solicitudes puede enviar la aplicación en un segundo |

Al marcar una opción aparece el campo `Introduzca el número de solicitudes`. Puede
activar cualquiera de ellas o ambas a la vez.

![Ventana con la configuración del límite de solicitudes](docs:api-request-limits/request-limit-settings_en)

La configuración se rige por dos reglas:

- el valor mínimo admitido es `1`; de lo contrario, el portal le avisa con
  `Minimum value is 1`
- si activa ambas opciones, el límite por segundo no puede ser mayor que el límite
  por minuto; de lo contrario, aparece `El valor no debe exceder las solicitudes por minuto.`

El botón `Salvar` permanece desactivado hasta que se cumplan ambas reglas, y también
hasta que cambie los valores con respecto a los que ya están guardados.

## Cómo se cuenta el límite

El contador está vinculado al segundo y al minuto del calendario, no a una ventana
deslizante. En cuanto empieza un nuevo segundo (un nuevo minuto en el caso del límite
por minuto), el contador vuelve a empezar desde cero.

> [!TIP]
> El límite por segundo sirve para suavizar los picos y el límite por minuto, para el
> ritmo general. Si configura ambos, se aplican a la vez: una solicitud solo pasa
> cuando cabe en los dos.

## Cómo eliminar el límite

La flecha junto al botón `Editar` abre un menú con la opción `Borrar`. La ventana de
confirmación `Eliminar límites de solicitudes de API` pregunta `¿Está seguro de que
desea eliminar los límites de solicitud de API?`; una vez confirmada, la API deja de
restringir el ritmo de sus llamadas.