🔐 Guía de Autenticación JWT
Cómo obtener y utilizar tokens de acceso para la API
📝 Introducción
Para garantizar la seguridad y el control de acceso a los datos de negocio, la API utiliza tokens JWT (JSON Web Tokens). Actualmente, la gestión de usuarios y generación de tokens se realiza a través de Supabase.
🚀 Obtención del Token
Siga estos pasos para obtener un token de acceso válido:
- Registro/Login: El usuario debe autenticarse contra el SDK de Supabase o el endpoint de Auth de Supabase.
- Extracción del Access Token: Una vez autenticado correctamente, Supabase devolverá
un objeto de sesión que contiene el
access_token.
💡 Nota: Los tokens tienen una duración limitada. Asegúrese de implementar la lógica de
refresco o re-autenticación si el token expira (Error 401).
🛠️ Uso del Token en la API
El token debe incluirse en todas las peticiones a los endpoints protegidos
(especialmente los de Comparador) mediante la cabecera HTTP Authorization.
Authorization: Bearer
Ejemplo con cURL
curl -X GET "http://localhost:5000/comparador_anual_tarifa/ES0031.../TARIFA_1" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
⚠️ Errores de Autenticación
| Código | Mensaje / Razón |
|---|---|
401 Unauthorized |
El token no es válido, ha expirado o no se ha proporcionado la cabecera Authorization. |
403 Forbidden |
El token es válido pero el usuario no tiene permisos suficientes para acceder al recurso. |