Autenticacion

​

Resumen

1. POST /api/auth/login
2. Guardar token
3. Enviar Authorization: Bearer <token>
4. Renovar con POST /api/auth/refresh
5. Invalidar sesion con POST /api/auth/logout cuando corresponda

​

Base URL

• https://api.raul.ugps.io

​

Login

curl -X POST "https://api.raul.ugps.io/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin@ugps.cl",
    "password": "password123"
  }'

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "....",
  "user": {
    "user_id": "uuid",
    "email": "admin@ugps.cl"
  }
}

​

Header de autorizacion

curl "https://api.raul.ugps.io/api/auth/users/me" \
  -H "Authorization: Bearer TU_TOKEN"

​

Validar sesion

• validar que el login fue correcto
• inspeccionar permisos efectivos
• comprobar si el token sigue usable antes de ejecutar flujos largos

​

Renovar token

curl -X POST "https://api.raul.ugps.io/api/auth/refresh" \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "TU_REFRESH_TOKEN"
  }'

• si recibes 401 en una operacion protegida, intenta una sola renovacion
• si refresh tambien falla, exige login nuevo

​

Cerrar sesion

• el usuario cierra sesion manualmente
• quieres revocar sesiones previas
• detectas credenciales comprometidas

​

Errores comunes

​

Buenas practicas

• No persistir access tokens en logs.
• Renovar sesiones solo cuando sea necesario.
• No reutilizar refresh tokens invalidados.
• Validar sesion con /users/me al inicio de integraciones largas.

​

Endpoints relacionados

• POST /api/auth/login
• POST /api/auth/refresh
• POST /api/auth/logout
• GET /api/auth/users/me
• POST /api/auth/password-reset/request
• POST /api/auth/password-reset/confirm