Autenticación (API Key)
Descripción
La API Key es el método de autenticación de la API de Axios Central, 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.1Host: apidevstore.axiosmobile.mxx-api-key: {{apiKey}}Content-Type: application/json¿Cómo obtengo mi API Key?
Puedes generar y administrar tu propia API Key desde Axios Central, el portal de autoservicio para integradores:
Abrir Axios Central →Pasos
- Inicia sesión en Axios Central con tus credenciales de distribuidor.
- En el menú lateral, entra a la sección API Keys.
- Pulsa Generar API Key. La clave se mostrará una sola vez — cópiala y guárdala en un lugar seguro, no podrás volver a verla.
- Según el ambiente, la clave queda lista de distinta forma (ver nota abajo).
- Úsala en el header
x-api-keyde tus solicitudes.
Endpoints compatibles
Todos los recursos documentados operan bajo /v2 y se autentican con tu API Key enviada en el header x-api-key:
| Endpoint | Metodo |
|---|---|
/v2/transactions (Venta de eSIM) | POST |
/v2/sims/status (Estado de activación de SIM) | GET |
/v2/transactions/tae (Recargas) | POST |
/v2/transactions/check/:folio | GET |
/v2/balance | GET |
/v2/products | GET |
/v2/compatibility/imei/:imei (Validar IMEI) | GET |
Límite de peticiones (rate limit)
Todos los endpoints /v2 aplican un límite de peticiones. Si lo superas, la API responde 429 con el cuerpo { "error": "Too many requests, please try again later" }. Espera un momento antes de reintentar.
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. |
429 | {"error": "Too many requests, please try again later"} | Se superó el límite de peticiones. |
Probar Endpoint
Puedes probar la autenticación por API Key con el endpoint de productos: