Autenticación con API Key

Las integraciones con Lumen API se autentican mediante una API Key. Lumen te entrega una llave para cada ambiente al habilitar tu acceso.

AmbientesCopy Anchor Link

El prefijo identifica el ambiente al que pertenece la llave:

Una API Key de sandbox no funciona en producción y una llave de producción no funciona en sandbox.

Enviar la API KeyCopy Anchor Link

Incluye la API Key de Lumen como credencial Bearer en el encabezado Authorization de cada solicitud:

Authorization: Bearer lum_test_xxxxxxxxx

Por ejemplo:

curl -X POST https://api-sandbox.lumendte.com/v1/companies \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lum_test_xxxxxxxxx" \
  -d '{
    "legalName": "Distribuidora El Sol, S.A. de C.V.",
    "tradeName": "El Sol",
    "taxIdentityNumber": "0614-090590-123-4",
    "taxRegistrationNumber": "123456-7",
    "economicActivityCode": "46900",
    "taxpayerType": "SMALL"
  }'

No necesitas solicitar ni renovar un token antes de consumir la API.

Proteger tus llavesCopy Anchor Link

• Guarda la API Key en una variable de entorno o en un gestor de secretos.
• No la incluyas en código fuente, aplicaciones cliente, repositorios ni registros.
• Usa llaves distintas para sandbox y producción.
• Si una llave se expone, solicita su revocación y reemplazo inmediatamente.

Lumen te muestra la llave completa únicamente al entregarla. Consérvala en un lugar seguro.

Errores de autenticaciónCopy Anchor Link

Una credencial ausente, inválida, revocada o utilizada en el ambiente incorrecto devuelve una respuesta 401 Unauthorized.

Integraciones existentesCopy Anchor Link

Si actualmente utilizas client_id y client_secret para obtener un token temporal, consulta cómo actualizar las credenciales de tu integración.