Endpoints / Usuarios
Actualizar contraseña de usuario
Actualiza la contraseña de un usuario de la empresa autenticada sin devolver la contraseña ni el hash generado.
/users/:id/passwordCaso de Uso
Se usa cuando un usuario con rol jefe necesita cambiar o restablecer la contraseña de otro usuario de su misma empresa. Al usarlo, el usuario obtiene una confirmación de que la contraseña fue actualizada correctamente.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
idstringobligatorioIdentificador del usuario al que se le actualizará la contraseña.
Body
uspasswordstringobligatorioNueva contraseña del usuario; debe tener al menos 8 caracteres.
Reglas de negocio
Solo un usuario autenticado con rol jefe puede actualizar contraseñas.
El usuario autenticado debe pertenecer a una empresa activa.
El usuario autenticado debe estar activo.
El usuario objetivo debe existir en la misma empresa del usuario autenticado.
No se permite actualizar la contraseña de usuarios de otra empresa.
La contraseña es obligatoria.
La contraseña debe tener al menos 8 caracteres.
La contraseña se cifra antes de guardarse.
La respuesta no incluye la contraseña ni el hash generado.
Errores esperados
No se envió un identificador de usuario válido en la ruta.
No se envió un token JWT válido o el token no fue aceptado.
No existe un usuario con el id indicado dentro de la empresa autenticada.
No se envió el campo uspassword en el body.
La contraseña enviada no cumple con la longitud mínima requerida.
No se encontró la empresa asociada al usuario autenticado.
La empresa del usuario autenticado no está en estado activo.
No se encontró el usuario autenticado en la empresa.
El usuario autenticado no pertenece a la empresa asociada al token.
El usuario autenticado intenta operar sobre una empresa diferente.
El rol del usuario autenticado no está permitido para acceder al módulo de usuarios.
El usuario autenticado no está en estado activo.
El usuario autenticado no tiene el rol requerido para actualizar contraseñas.
Ocurrió un error interno al guardar la nueva contraseña.
Notas de uso
Envía el id del usuario en la ruta, no en el body.
Envía el body en formato JSON con el header Content-Type: application/json.
Usa una contraseña de al menos 8 caracteres.
Guarda el token JWT de forma segura y envíalo en cada solicitud protegida.
La respuesta confirma la actualización, pero no devuelve información sensible.