Reten Docs
Autenticación

Iniciar Sesión

Autenticar un usuario y recibir tokens de acceso y renovació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

CampoTipoRequeridoDescripción
identifierstringNombre de usuario o correo electrónico
passwordstringContraseñ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 200 OK

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "admin@example.com",
    "firstName": "Admin",
    "lastName": "User"
  }
}

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

Respuestas de Error

EstadoDescripción
401Correo electrónico o contraseña inválidos