Saltar al contenido

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.1
Host: apidevstore.axiosmobile.mx
x-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

  1. Inicia sesión en Axios Central con tus credenciales de distribuidor.
  2. En el menú lateral, entra a la sección API Keys.
  3. 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.
  4. Según el ambiente, la clave queda lista de distinta forma (ver nota abajo).
  5. Úsala en el header x-api-key de 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:

EndpointMetodo
/v2/transactions (Venta de eSIM)POST
/v2/sims/status (Estado de activación de SIM)GET
/v2/transactions/tae (Recargas)POST
/v2/transactions/check/:folioGET
/v2/balanceGET
/v2/productsGET
/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 HTTPBodyCausa
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:

GEThttps://apidevstore.axiosmobile.mx/v2/products
Prueba de autenticación con API Key — Ingresa tu x-api-key para probar el acceso.
Headers