Rate limits y códigos de error

El límite de peticiones (rate limit) protege la API frente a sobrecarga y abuso. Si en poco tiempo envía demasiadas peticiones, el servidor devolverá la respuesta HTTP 429 Too Many Requests con la cabecera Retry-After, que indica cuántos segundos hay que esperar.

Límites actuales

• El límite es de 60 peticiones por minuto por cada token. Se aplica por igual a todos los planes (Trial, Estándar, Profi y Business).
• Los agentes LAN tienen un límite independiente de 120 peticiones por minuto por cada agente.
• El límite se calcula por cada token por separado (no para el usuario completo). Si necesita un techo total más alto, cree varios tokens para distintos usos (por ejemplo, uno aparte para CI/CD y otro aparte para el dashboard).

Códigos de error

• 401 Unauthorized - token ausente o no válido.
• 403 Forbidden - la acción no está disponible en su plan (por ejemplo, crear un monitor tras la expiración del plan o por encima del límite de su plan).
• 404 Not Found - el recurso (monitor, incidente) no existe o no tiene acceso a él.
• 429 Too Many Requests - se ha superado el límite de peticiones. Espere los segundos indicados en la cabecera Retry-After.
• 5xx - error del lado del servidor. Reinténtelo con un retraso que aumente de forma progresiva (exponential backoff - por ejemplo 1, 2, 4, 8 segundos).

Recomendaciones prácticas

• Almacene las respuestas de los endpoints de lectura en una memoria caché. Los datos de disponibilidad no cambian cada segundo, por lo que no es necesario consultarlos tantas veces.
• Cuando sea posible, en lugar de consultas repetidas (polling) utilice webhooks - el servidor le avisará por sí mismo cuando ocurra un evento.
• En operaciones por lotes añada un pequeño retraso entre peticiones para no acercarse al límite.