Endpoints / Usuarios
Obtener usuario
Obtiene el detalle de un usuario por su identificador, dentro de la empresa del usuario autenticado.
/users/:idCaso de Uso
Se usa cuando la aplicación necesita cargar los datos completos de un usuario para una vista de detalle, un formulario de edición o la administración de personal. Al usarlo, el usuario obtiene los datos del usuario incluyendo su nombre, apodo, correo, rol, estado y la URL pública de su imagen de perfil.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol administrador, jefe o empleado. La empresa y el usuario autenticado deben estar activos.
Parámetros de ruta
idstringobligatorioIdentificador del usuario.
Body
No aplica.
Reglas de negocio
El usuario autenticado debe tener rol administrador, jefe o empleado.
Solo permite consultar usuarios de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El campo usimagen se devuelve como URL pública completa.
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 en la ruta.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a una empresa distinta a la suya.
El rol del usuario no está permitido para acceder al módulo de usuarios.
El usuario autenticado está inactivo y no puede usar el sistema.
No existe un usuario con el id indicado dentro de la empresa del usuario autenticado.
Notas de uso
Este endpoint no recibe query params ni body.
Solo devuelve usuarios que pertenecen a la empresa del usuario autenticado.
usimagen se devuelve como URL pública completa, lista para usar en etiquetas <img>.