Cómo funcionan los límites de acciones de la API

Para garantizar la confiabilidad y el desempeño de nuestra API, monday.com aplica varios límites de acciones. Estos límites ayudan a gestionar la carga del sistema y garantizan el uso justo para todos los usuarios. Cuando se alcanzan estos límites, puede haber errores temporales, pero entenderlos ayuda a evitar problemas.

Puedes encontrar detalles técnicos y ejemplos en nuestros documentos para desarrolladores sobre los límites de uso.

Tipos de límites de uso

1. Límite de complejidad

Esto controla qué tan “pesada” es una consulta. La mayoría de los usuarios no lo superan, pero si ocurre, verás un error:

• Mensaje de error: COMPLEXITY_BUDGET_EXHAUSTED
• Qué hacer:
• Solo solicita los datos que necesites
• Evita las consultas demasiado complejas o anidadas
• Usa la paginación en la medida que sea posible

2. Límite diario de llamadas

Cada cuenta tiene un límite diario en la cantidad de llamadas a la API:

• Mensaje de error: DAILY_LIMIT_EXCEEDED

• Qué hacer:
• Optimiza tu código para reducir las llamadas innecesarias
• Espera hasta que se restablezcan los límites a la medianoche de UTC
• Si tienes un plan de nivel Enterprise, puedes solicitar un aumento mediante el panel de análisis de API que está en la sección de administración en monday.com.

3. Límite de acciones por minuto

Esto limita la cantidad de consultas por minuto. En caso de superarse:

• Mensaje de error: límite de acciones excedido
• Qué hacer:
• Reduce la frecuencia de las solicitudes
• Usa el encabezado de reintentar después para saber cuándo puedes volver a intentar de forma segura.

4. Límite de concurrencia

Restringe cuántas llamadas a la API se pueden gestionar al mismo tiempo.

• Mensaje de error: maxConcurrencyExceeded
• Qué hacer:
• Envía menos solicitudes en paralelo.
• Agrega un lógica de reintento antes de volver a probar.

5. Límite de IP

Limita la cantidad de solicitudes de una IP individual en un periodo corto (5,000 solicitudes dentro de 10 segundos).

• Mensaje de error: IP_RATE_LIMIT_EXCEEDED
• Qué hacer:
• Haz una pausa antes de reintentar, según lo sugerido en el campo retry_in_seconds (reintentar en X segundos) en el mensaje de error.

Prácticas recomendadas generales

• Todas las solicitudes (incluso las fallidas) se cuentan dentro de tus límites.
• Evita reintentar las solicitudes inmediatamente después de un límite de error de acciones. Siempre consulta el campo retry_in_seconds (reintentar en X segundos) en la respuesta.
• Si usas nuestro SDK, respeta automáticamente las respuestas en el límite de uso y reintenta la llamada después de un tiempo de espera adecuado.

En el caso de los desarrolladores, recomendamos revisar los documentos sobre límites de uso para entender cómo se aplican los límites según tu caso de uso y tu plan.

¿Necesitas ayuda para optimizar tu uso de la API? Comunícate con nosotros para solicitar ayuda.