Endpoints / Alertas
Marcar alerta como vista
Marca una alerta visible como vista dentro de la empresa del usuario autenticado.
/alerts/:id/vistoCaso de Uso
Se usa cuando el usuario ya revisó una alerta y la aplicación necesita quitarla del estado pendiente. Al usarlo, el usuario obtiene una confirmación de que la alerta fue marcada como vista.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
idstringobligatorioIdentificador de la alerta.
Body
No aplica.
Reglas de negocio
Solo permite marcar 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 alerta debe existir dentro de la empresa autenticada.
Solo se pueden marcar como vistas las alertas visibles.
Si la alerta ya estaba vista, el endpoint responde correctamente y mantiene la alerta como vista.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro id o se envió vacío.
La alerta no existe, no pertenece a la empresa autenticada o no está visible.
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 marcar alertas como vistas.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
No recibe body ni query params.
Envía el identificador de la alerta en la ruta, reemplazando :id.
La operación actualiza el campo alvisto a true.
Si necesitas consultar alertas no vistas después de marcar una alerta, usa GET /alerts?visto=false.
Si la alerta ya no está visible, el endpoint responde como alerta no encontrada.