Límites de peticiones de la API
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 Requestsy 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: controla el ritmo de sus llamadas, no el volumen que envía.
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
- En el menú del portal, haga clic en
Módulos y APIs - En
Mis APIs y módulos, haga clic en la tarjeta de su aplicación - Permanezca en la pestaña
Ajustesy desplácese hasta la parteLí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.
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.
La configuración se rige por dos reglas:
- el valor mínimo admitido es
1; de lo contrario, el portal le avisa conMinimum 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.
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.
Gracias por su opinión.