Users

Users

Gestión de usuarios del sistema. Consulta, actualización y cambio de contraseña.

GET /api/users/v1/me

Obtener usuario autenticado

Datos del usuario

Respuestas

200

Datos del usuario autenticado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "user@example.com",
    "phone": "phone",
    "role": "SUPERADMIN",
    "enabled": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/users/v1

Listar todos los usuarios

Lista de usuarios

Respuestas

200

Lista de usuarios

{
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "user@example.com",
    "phone": "phone",
    "role": "SUPERADMIN",
    "enabled": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/users/v1/{id}

Obtener usuario por ID

Parámetros

Nombre	Tipo	Requerido	Descripción
id	string	✅

Respuestas

200

Datos del usuario

{
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "user@example.com",
    "phone": "phone",
    "role": "SUPERADMIN",
    "enabled": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

404

Usuario no encontrado

{
    "error": "Mensaje descriptivo del error",
    "timestamp": "2024-01-15T10:00:00Z"
  }

---

PATCH /api/users/v1/{id}

Actualizar usuario

Parámetros

Nombre	Tipo	Requerido	Descripción
id	string	✅

Request Body (requerido ✅)

{
    "firstName": "firstName",
    "lastName": "lastName",
    "phone": "phone"
  }

Respuestas

200

Usuario actualizado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "user@example.com",
    "phone": "phone",
    "role": "SUPERADMIN",
    "enabled": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

DELETE /api/users/v1/{id}

Eliminar usuario (soft delete)

Parámetros

Nombre	Tipo	Requerido	Descripción
id	string	✅

Respuestas

204

Usuario eliminado exitosamente

---

POST /api/users/v1/{id}/change-password

Cambiar contraseña

Contraseña actual incorrecta

Parámetros

Nombre	Tipo	Requerido	Descripción
id	string	✅

Request Body (requerido ✅)

{
    "currentPassword": "currentPassword",
    "newPassword": "newPassword"
  }

Respuestas

200

Contraseña cambiada exitosamente

400

Contraseña actual incorrecta

{
    "error": "Mensaje descriptivo del error",
    "timestamp": "2024-01-15T10:00:00Z"
  }

---

Schemas

UserResponse

Campo	Tipo	Requerido	Descripción
id	string (uuid)	❌
firstName	string	❌
lastName	string	❌
email	string (email)	❌
phone	string	❌
role	Role	❌
enabled	boolean	❌
createdAt	string (date-time)	❌
updatedAt	string (date-time)	❌

ErrorResponse

Campo	Tipo	Requerido	Descripción
error	string ej: “Mensaje descriptivo del error”	❌
timestamp	string (date-time)	❌

UpdateUserRequest

Campo	Tipo	Requerido	Descripción
firstName	string	❌
lastName	string	❌
phone	string	❌

ChangePasswordRequest

Campo	Tipo	Requerido	Descripción
currentPassword	string	✅
newPassword	string	✅