Actualizar credenciales
Actualiza una integración existente para utilizar una API Key de Lumen.
Si tu integración obtiene un token temporal mediante client_id y client_secret, puede continuar funcionando sin cambios. Esta guía explica cómo actualizarla para utilizar una API Key directamente.
Los endpoints y cuerpos de tus solicitudes no cambian. Ambos mecanismos utilizan el encabezado Authorization, por lo que solo debes reemplazar la credencial enviada como Bearer.
1. Recibe tu API Key
Lumen te entrega una API Key para el ambiente que utiliza tu integración:
lum_test_...para sandbox.lum_live_...para producción.
Guarda la llave en una variable de entorno o en un gestor de secretos. Lumen te muestra la llave completa una sola vez al entregarla.
2. Reemplaza la credencial
Tu integración actual obtiene un token temporal que envía en cada solicitud:
Authorization: Bearer <access_token>Reemplázalo por la API Key:
Authorization: Bearer lum_test_xxxxxxxxxPor ejemplo, cambia la variable que utiliza tu cliente HTTP:
- LUMEN_CLIENT_ID=<client_id>
- LUMEN_CLIENT_SECRET=<client_secret>
+ LUMEN_API_KEY=lum_test_xxxxxxxxx- Authorization: Bearer ${ACCESS_TOKEN}
+ Authorization: Bearer ${LUMEN_API_KEY}3. Simplifica la autenticación
La API Key no requiere solicitar ni renovar un token temporal. Puedes retirar de tu integración:
- La solicitud de autenticación con
client_idyclient_secret. - El almacenamiento temporal del
access_token. - La lógica que renueva el token según
expires_in.
Conserva el manejo de respuestas 401 Unauthorized: puede indicar que la API Key es inválida, fue revocada o pertenece a otro ambiente.
4. Verifica y retira las credenciales anteriores
Prueba la integración con la API Key en sandbox antes de cambiar producción. Cuando hayas confirmado que todas las solicitudes funcionan, deja de utilizar client_id y client_secret.
Si todavía no puedes actualizarla, consulta la referencia para integraciones existentes.