Auth

Auth

Autenticación JWT. Registro, inicio de sesión, renovación de tokens, cierre de sesión, verificación de email y restablecimiento de contraseña.

POST /api/auth/v1/register

Registrar usuario

Crea un nuevo usuario. Si se envía companyId, automáticamente crea un CompanyMember con rol employee en esa empresa.

Request Body (requerido ✅)

{
    "firstName": "Juan",
    "lastName": "Pérez",
    "email": "juan@test.com",
    "password": "password123",
    "phone": "123456789",
    "companyId": "00000000-0000-0000-0000-000000000000"
  }

Respuestas

201

Usuario registrado

{
    "accessToken": "accessToken",
    "refreshToken": "refreshToken",
    "user": {
      "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"
    }
  }

400

Email ya registrado o datos inválidos

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

---

POST /api/auth/v1/login

Iniciar sesión

Request Body (requerido ✅)

{
    "email": "juan@test.com",
    "password": "password123"
  }

Respuestas

200

Inicio de sesión exitoso

{
    "accessToken": "accessToken",
    "refreshToken": "refreshToken",
    "user": {
      "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"
    }
  }

401

Credenciales inválidas

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

---

POST /api/auth/v1/refresh

Refrescar token JWT

Request Body (requerido ✅)

{
    "refreshToken": "refreshToken"
  }

Respuestas

200

Token renovado

{
    "accessToken": "accessToken",
    "refreshToken": "refreshToken",
    "user": {
      "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"
    }
  }

401

Token inválido o expirado

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

---

POST /api/auth/v1/logout

Cerrar sesión

Request Body (requerido ✅)

{
    "refreshToken": "refreshToken"
  }

Respuestas

200

Sesión cerrada exitosamente

---

POST /api/auth/v1/verify-email

Verificar email

Email verificado

Request Body (requerido ✅)

{
    "token": "token"
  }

Respuestas

200

Email verificado exitosamente

---

POST /api/auth/v1/password-reset

Solicitar restablecimiento de contraseña

Request Body (requerido ✅)

{
    "email": "user@example.com"
  }

Respuestas

200

Email de restablecimiento enviado (si el email existe)

---

POST /api/auth/v1/password-reset/confirm

Confirmar restablecimiento de contraseña

Contraseña actualizada

Request Body (requerido ✅)

{
    "token": "token",
    "newPassword": "newPassword"
  }

Respuestas

200

Contraseña actualizada exitosamente

---

Schemas

RegisterRequest

Campo	Tipo	Requerido	Descripción
firstName	string ej: “Juan”	✅
lastName	string ej: “Pérez”	✅
email	string (email) ej: “juan@test.com”	✅
password	string ej: “password123”	✅
phone	string ej: “123456789”	✅
companyId	string (uuid)	❌	Opcional. Si se envía, crea CompanyMember con rol employee

AuthResponse

Campo	Tipo	Requerido	Descripción
accessToken	string	❌
refreshToken	string	❌
user	UserResponse	❌

ErrorResponse

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

LoginRequest

Campo	Tipo	Requerido	Descripción
email	string (email) ej: “juan@test.com”	✅
password	string ej: “password123”	✅

RefreshTokenRequest

Campo	Tipo	Requerido	Descripción
refreshToken	string	✅

VerifyEmailRequest

Campo	Tipo	Requerido	Descripción
token	string	✅

PasswordResetRequest

Campo	Tipo	Requerido	Descripción
email	string (email)	✅

PasswordResetConfirmRequest

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