Autenticacion

Autenticacion JWT

Los endpoints protegidos requieren un access token enviado en el header Authorization. El login devuelve un accessToken para consumir la API y un refreshToken para renovar la sesion.

Header requerido

Authorization: Bearer <access_token>

Flujo de autenticacion

1
Login

El usuario inicia sesion con POST /auth/login usando RUC, apodo y contrasena.

2
Tokens

El backend devuelve accessToken y refreshToken cuando la empresa y el usuario estan activos.

3
Consumo protegido

El accessToken se envia en Authorization para consumir endpoints protegidos.

4
Renovacion

Cuando el accessToken expira, se renueva usando POST /auth/refresh con el refreshToken.

Ejemplo de login

curl -X POST https://api.ferreconst.space/auth/login   -H "Content-Type: application/json"   -d '{
    "emruc": "1709639106001",
    "usapodo": "jperez",
    "uspassword": "secreto123"
  }'

Seguridad

Intentos fallidos

El login puede bloquear temporalmente una combinacion de empresa, usuario e IP.

Refresh token

Usalo solo para renovar sesion; no debe enviarse en cada endpoint protegido.

Usuario activo

El backend valida que el usuario y la empresa se encuentren activos.

Endpoints publicos

Login, refresh y algunos endpoints de sistema pueden no requerir token JWT.