Saltar al contenido principal

Flujo de Gestión de Tokens

El servicio de gestión de tokens sigue un proceso automatizado para mantener válido el acceso a la API de MercadoLibre:

🔍 Verificación Periódica​

El servicio realiza verificaciones regulares del estado de los tokens:

  • Consulta programada: Cada 20 minutos se verifica el estado del token actual.
  • Validación de vencimiento: Se comprueba si el token expirará en la próxima hora.
  • Verificación de integridad: Se valida que el token almacenado sea válido y funcional.

⚠️ Detección de Vencimiento Próximo​

Cuando el token está próximo a vencer:

  • Se activa el proceso de renovación automática.
  • Se registra el evento en los logs del sistema.
  • Se prepara el refresh token para la renovación.

🔄 Proceso de Renovación​

El proceso de renovación sigue estos pasos:

  1. Obtención del refresh token: Se recupera el refresh token válido de la base de datos.
  2. Llamada a la API: Se realiza una petición a la API de OAuth de MercadoLibre.
  3. Validación de respuesta: Se verifica que la respuesta contenga un nuevo access token válido.
  4. Actualización en base de datos: Se almacena el nuevo token con su fecha de vencimiento.
  5. Backup del token anterior: Se mantiene un historial para auditoría.

💾 Almacenamiento Seguro​

  • Versionado: Se mantiene un historial de tokens para trazabilidad.
  • Limpieza automática: Los tokens expirados se marcan como inactivos tras un período de gracia.

🚨 Manejo de Errores​

Token Inválido​

Si el refresh token es inválido:

  1. Pausa del servicio: Se detiene temporalmente la integración de pedidos.
  2. Registro de auditoría: Se documenta el evento para investigación.
  3. Intervención manual: Se requiere regenerar los tokens desde MercadoLibre.

Pérdida de Conectividad​

Si no hay acceso a la API de MercadoLibre:

  1. Reintentos programados: Se reintenta la conexión cada 20 minutos.
  2. Validación local: Se verifica si el token actual sigue siendo válido localmente.
  3. Postponer renovación: Se aplaza la renovación hasta restaurar la conectividad.
nota

El servicio está diseñado para operar de forma autónoma, pero requiere supervisión periódica para garantizar la continuidad del negocio.