Todos los endpoints de autenticación están bajo /api/auth/.

Resumen

Bedrud admite múltiples métodos de autenticación:

Formato de Token

La autenticación exitosa devuelve un par de tokens JWT:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIs..."
}

• Access Token - De corta duración, se usa en el encabezado Authorization
• Refresh Token - De larga duración, se usa para obtener nuevos tokens de acceso

Uso de Tokens

Incluya el token de acceso en todas las solicitudes autenticadas:

Authorization: Bearer <accessToken>

Endpoints

Registrar

Crea una nueva cuenta de usuario.

POST /api/auth/register

Cuerpo de la Solicitud:

{
  "email": "user@example.com",
  "password": "securepassword",
  "name": "John Doe"
}

Respuesta (200):

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "user": {
    "id": "uuid",
    "email": "user@example.com",
    "name": "John Doe",
    "role": "user"
  }
}

Iniciar Sesión

Autenticarse con correo y contraseña.

POST /api/auth/login

Cuerpo de la Solicitud:

{
  "email": "user@example.com",
  "password": "securepassword"
}

Respuesta (200):

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "user": {
    "id": "uuid",
    "email": "user@example.com",
    "name": "John Doe",
    "role": "user"
  }
}

Iniciar Sesión como Invitado

Únete como invitado sin crear una cuenta. Los invitados tienen permisos limitados.

POST /api/auth/guest-login

Cuerpo de la Solicitud:

{
  "name": "Guest User"
}

Respuesta (200):

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "user": {
    "id": "uuid",
    "name": "Guest User",
    "role": "guest"
  }
}

Obtener Usuario Actual

Recupera el perfil del usuario autenticado.

GET /api/auth/me

Encabezados: Authorization: Bearer <accessToken>

Respuesta (200):

{
  "id": "uuid",
  "email": "user@example.com",
  "name": "John Doe",
  "avatar": "https://...",
  "role": "user",
  "provider": "email"
}

Renovar Token

Intercambia un token de actualización por un nuevo token de acceso.

POST /api/auth/refresh

Cuerpo de la Solicitud:

{
  "refreshToken": "eyJ..."
}

Respuesta (200):

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ..."
}

Cerrar Sesión

Invalida el token de actualización actual.

POST /api/auth/logout

Encabezados: Authorization: Bearer <accessToken>

Cuerpo de la Solicitud:

{
  "refreshToken": "eyJ..."
}

Respuesta (200):

{
  "message": "logged out"
}

Inicio de Sesión OAuth

Inicia un flujo OAuth con un proveedor social.

GET /api/auth/:provider/login

Proveedores Admitidos:

El servidor redirige al usuario a la página de autorización del proveedor. Después del consentimiento, el proveedor redirige de vuelta a la URL de devolución de llamada, y el servidor devuelve tokens JWT.

Respuestas de Error

Todos los endpoints de autenticación devuelven errores en este formato:

{
  "error": "invalid credentials"
}

Véase también

• Flujo de Autenticación - cómo funcionan JWT, OAuth y passkeys internamente
• API de Passkeys - referencia de endpoints FIDO2/WebAuthn