Endpoints / Alertas
Listar eventos de alerta
Abre una conexión de eventos en tiempo real para recibir cambios de alertas de la empresa del usuario autenticado.
/alerts/eventsCaso de Uso
Se usa cuando la aplicación necesita mostrar alertas nuevas, actualizadas o resueltas sin consultar repetidamente el listado de alertas. Al consumirlo, el usuario recibe eventos en tiempo real mientras la conexión permanezca abierta.
Autenticación
Requiere token JWT en el header Authorization: Bearer <token>.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
No aplica.
Reglas de negocio
Solo se envían alertas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol administrador, jefe o empleado.
La conexión se mantiene abierta hasta que el cliente la cierre.
El servidor revisa cambios de alertas cada 5 segundos.
El servidor envía un evento connected al abrir la conexión.
El servidor puede enviar eventos alert-created, alert-updated o alert-resolved.
El servidor envía señales de mantenimiento :keepalive para conservar activa la conexión.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
La empresa asociada al usuario autenticado no fue encontrada.
El usuario autenticado no fue encontrado dentro de su empresa.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a información de una empresa distinta a la suya.
El rol del usuario no tiene permiso para escuchar eventos de alertas.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint usa Server-Sent Events, por lo que la respuesta tiene formato text/event-stream.
Usa una conexión persistente y ciérrala cuando el usuario salga de la pantalla o cierre sesión.
Para pruebas con cURL, usa -N para ver los eventos a medida que llegan.
Si el token expira, abre una nueva conexión después de renovar la sesión.
El evento connected confirma que la suscripción quedó abierta correctamente.