Autenticación (API Key)

Descripción

La API Key es un método de autenticación alternativo al JWT, diseñado para integraciones servidor-a-servidor que no requieren un flujo interactivo de login. Con una API Key, puedes autenticar cada solicitud directamente con un solo header, sin necesidad de obtener y renovar tokens.

Es ideal para:

• Integraciones backend automatizadas.
• Servicios que consumen la API de forma continua.
• Clientes que prefieren un mecanismo de autenticación más simple (una sola credencial por request).

---

¿Cómo se usa?

Envía tu API Key en el header x-api-key en cada solicitud:

POST /v2/transactions HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}
Content-Type: application/json

Seguridad

Tu API Key es una credencial sensible. No la expongas en código frontend, repositorios públicos, ni la compartas con terceros. Trátala con el mismo cuidado que una contraseña.

---

¿Cómo obtengo mi API Key?

Contacta al equipo de soporte Axios para solicitar la generación y activación de tu API Key.

---

Endpoints compatibles

No todos los endpoints soportan API Key. La siguiente tabla muestra la compatibilidad:

Endpoint	JWT	API Key
POST /v1/auth/:appId	—	No aplica (es para obtener JWT)
POST /v1/transactions (Recargas)	✅	❌
GET /v1/balance	✅	❌
GET /v1/products/tae	✅	✅
POST /v2/transactions (Activación eSIM)	✅	✅
POST /v1/external/portability/*	❌	✅

Endpoints con autenticación híbrida

Los endpoints marcados con ✅ en ambas columnas soportan autenticación híbrida: el sistema detecta automáticamente cuál mecanismo estás usando según la presencia del header x-api-key.

---

Respuestas de error

Código HTTP	Body	Causa
401	{"error": "Missing API key"}	No se envió el header x-api-key.
403	{"error": "Invalid or inactive API key"}	La clave es incorrecta o no está habilitada.