Saltar al contenido principal

Métodos de Autenticación

BaseGes ERP API cuenta con dos modalidades de autenticación según el escenario de integración.

1. API Key (Integraciones Machine-to-Machine)​

Recomendada para sincronizaciones backend entre servidores, procesos batch, CRMs o plataformas de comercio electrónico.

La clave de API se vincula directamente a una empresa y usuario de sistema en la configuración de BaseGes:

  • Cabecera HTTP requerida:
X-Api-Key: tu_clave_secreta_aqui
Ventajas de la API Key
  • No expira periódicamente (salvo revocación manual).
  • Elimina la necesidad de realizar un handshake de login previo antes de cada petición.

2. JWT Bearer Token (Sesiones de Usuario / Movilidad)​

Indicada para aplicaciones interactivas, portales web de clientes o aplicaciones móviles para operarios de campo.

Paso 1: Obtener el Token​

Realice una petición POST /api/auth/login con las credenciales del usuario:

curl -X POST "http://localhost:5000/api/auth/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "operario1",
       "password": "PasswordSeguro123"
     }'

Respuesta:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2026-10-23T20:00:00Z"
}

Paso 2: Usar el Token en Peticiones​

Incluya el token en la cabecera estándar Authorization y el código de empresa en X-Company-Id:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Company-Id: 001