Iniciar Sesión

POST /api/auth/login

Autentica un usuario con nombre de usuario o correo electrónico y contraseña. Devuelve un token de acceso en el cuerpo de la respuesta y establece un token de actualización como cookie HTTP-only.

Auth: Pública (no requiere autenticación)

Cuerpo de la Solicitud

Campo	Tipo	Requerido	Descripción
`identifier`	string	Sí	Nombre de usuario o correo electrónico
`password`	string	Sí	Contraseña del usuario (mínimo 8 caracteres)

Ejemplo

curl -X POST https://api.reten.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "admin@example.com",
    "password": "SecurePass123!"
  }'

const response = await fetch("https://api.reten.ai/api/auth/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    identifier: "admin@example.com",
    password: "SecurePass123!",
  }),
});
const data = await response.json();
const accessToken = data.accessToken;

import requests

response = requests.post(
    "https://api.reten.ai/api/auth/login",
    json={
        "identifier": "admin@example.com",
        "password": "SecurePass123!",
    },
)
data = response.json()
access_token = data["accessToken"]

Respuesta `201 Created`

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "username": "jdoe",
    "email": "jdoe@example.com",
    "firstName": "Jane",
    "lastName": "Doe",
    "roles": ["viewer"],
    "permissions": [
      "project:view",
      "user:view",
      "activity:view",
      "commerce-lifecycle-snapshot:view"
    ],
    "tenantIds": ["660e8400-e29b-41d4-a716-446655440000"]
  }
}

Campo	Tipo	Descripción
`accessToken`	string	Token de acceso para el header `Authorization: Bearer`
`user.roles`	string[]	Valores de rol del usuario (ver Roles y Permisos)
`user.permissions`	string[]	Permisos que otorgan todos los roles del usuario; el orden no está garantizado
`user.tenantIds`	string[]	Tenants a los que pertenece el usuario — cada uno es un `x-tenant-id` válido

El token de acceso lleva roles, permissions y tenantIds tal como estaban cuando se emitió: un cambio de roles surte efecto en el siguiente inicio de sesión o en la siguiente renovación.

El token de actualización se establece como una cookie HTTP-only (refreshToken) con una expiración de 7 días.

Respuestas de Error

Estado	Descripción
`400`	Error de validación — `identifier` está vacío o `password` tiene menos de 8 caracteres
`401`	Identificador o contraseña incorrectos — `Invalid credentials`
`401`	El usuario está desactivado — `User account is deactivated`