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
| 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 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
| Estado | Descripción |
|---|---|
401 | Correo electrónico o contraseña inválidos |