Autenticación
La API usa JWT Bearer tokens. El flujo tiene tres pasos:
- Envía tus credenciales a
POST /api/auth/client/login. - La respuesta incluye
token.access_token. - Adjunta el token en cada petición:
Authorization: Bearer {access_token}.
:::info Endpoints públicos
Los endpoints bajo /api/open/ son públicos y no requieren token.
:::
Vigencia del token
- 15 minutosDesde que se emite (
expires_in: 900, en segundos). - Sin renovaciónNo existe un endpoint para renovarlo: al vencer, repite el login.
- A los 14 minutosMomento sugerido para pedir uno nuevo, antes de que venza.
Cuando vence, solicita uno nuevo repitiendo el login con tu client_id y client_secret. Renovarlo un poco antes de que venza evita errores en medio de una operación.
Errores de autenticación
| Código | response_message | Cuándo ocurre |
|---|---|---|
401 | Credenciales inválidas | El client_id no existe o el client_secret no coincide. |
403 | API client desactivado | Las credenciales son correctas, pero el cliente API está desactivado. |
401 | Autenticación requerida | La petición no incluye el header Authorization: Bearer .... |
401 | Token inválido o expirado | El token venció o no es válido. Solicita uno nuevo. |