Validar Compatibilidad de IMEI

Descripción

Este método permite validar si un IMEI es compatible con la red de Axios Mobile (Altan) antes de continuar con la activación de la eSIM. Consulta el estado del dispositivo (bloqueado, homologado, soporte VoLTE y banda 28) y regresa si es compatible junto con un mensaje explicativo para mostrar al cliente.

Flujo recomendado

Antes de solicitar la activación de una eSIM, se recomienda validar la compatibilidad del dispositivo del cliente con este endpoint. Así evitas reservar inventario y descontar saldo en un dispositivo que no podrá operar correctamente en la red AXIOS.

Este endpoint opera bajo /v1

A diferencia del endpoint de activación de eSIM (/v2/transactions), la validación de IMEI vive bajo el sub-recurso /v1/altan, es decir: https://apidevstore.axiosmobile.mx/v1/altan/imei/:imei.

---

URL API

BASE URLhttps://apidevstore.axiosmobile.mx/v1

---

Autenticación

Endpoint público — sin autenticación

Este endpoint no requiere autenticación. No es necesario enviar un token JWT en Authorization, ni una x-api-key. Puede consumirse directamente sin credenciales previas.

---

Parámetros de entrada

Parámetro	Tipo	Ubicación	Requerido	Descripción	Ejemplo
imei	string	Path param	Sí	IMEI del dispositivo a validar. Debe contener solo dígitos, entre 14 y 17 caracteres.	"358240051111110"

---

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v1/altan/imei/:imei

GET /v1/altan/imei/358240051111110 HTTP/1.1
Host: apidevstore.axiosmobile.mx

Headers: No aplica
Body: No aplica

---

Respuestas

200 — Consulta Exitosa Success

Sin envoltura estándar

A diferencia de otros endpoints de la API, esta respuesta no usa la envoltura { error, message, data, results }. Regresa directamente el objeto tal como lo entrega Altan, con los campos compatible y message agregados al nivel raíz.

{
  "imei": {
    "blocked": "NO",
    "homologated": "HOMOLOGADO"
  },
  "deviceFeatures": {
    "brand": "Apple",
    "volteCapable": "SI",
    "band28": "SI"
  },
  "compatible": true,
  "message": "Su equipo es compatible con nuestra red AXIOS."
}

Lógica de compatibilidad

Los campos compatible y message se calculan a partir de los datos que devuelve Altan:

Condición evaluada	compatible	message
blocked es "SI"	false	”El dispositivo se encuentra bloqueado, no puede ser utilizado en nuestra red AXIOS.”
homologated (HOMOLOGADO/VOLTE) + volteCapable: SI + band28: SI	true	”Su equipo es compatible con nuestra red AXIOS.”
No homologado + volteCapable: NO + band28: NO	false	”Lo sentimos, tu equipo no es compatible, pero tienes la opción de continuar.”
No homologado + volteCapable: SI + band28: SI	true	”Su equipo es compatible con nuestra red AXIOS, puede que necesite algunas configuraciones extras al insertar la SIM en el teléfono.”
volteCapable: NO + band28: SI + marca Apple	false	”Lo sentimos, tu equipo no es compatible, pero tienes la opción de continuar.”
volteCapable: NO + band28: SI + marca distinta de Apple (Android)	true	”Su equipo no cuenta con VoLTE (tecnología necesaria para realizar llamadas).”
Ninguna de las anteriores	false	”No hemos podido determinar si su dispositivo es compatible, por favor comuniquese a servicio al cliente.”

400 — Formato de IMEI incorrecto Client Error

Se retorna cuando el imei recibido no cumple el formato esperado (solo dígitos, entre 14 y 17 caracteres). Esta validación ocurre antes de consultar a Altan.

{ "error": "Formato de IMEI incorrecto" }

400 — Errores devueltos por Altan Client Error

Se retornan cuando Altan rechaza la solicitud por el formato del IMEI o porque no encuentra información asociada.

Formato inválido para Altan

{ "error": "El formato del imei no es el correcto" }

IMEI no encontrado

{ "error": "IMEI no encontrado" }

500 — Error Interno Server Error

Se retorna cuando ocurre un error inesperado al comunicarse con Altan que no coincide con los casos anteriores (por ejemplo, timeout o caída del servicio).

{ "error": "Ocurrió un error en el servidor" }

---

Parámetros de salida (Respuesta Exitosa)

Parámetro	Tipo	Descripción	Ejemplo
imei.blocked	string	Indica si el dispositivo está bloqueado ("SI" / "NO").	"NO"
imei.homologated	string	Estado de homologación del dispositivo.	"HOMOLOGADO"
deviceFeatures.brand	string	Marca del dispositivo.	"Apple"
deviceFeatures.volteCapable	string	Indica si soporta VoLTE ("SI" / "NO").	"SI"
deviceFeatures.band28	string	Indica si soporta banda 28 ("SI" / "NO").	"SI"
compatible	boolean	Resultado final: si el dispositivo es compatible con AXIOS.	true
message	string	Mensaje explicativo listo para mostrar al cliente.	"Su equipo es compatible con nuestra red AXIOS."

---

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v1/altan/imei/:imeiEnviar

Validar compatibilidad de IMEI — Endpoint público, no requiere autenticación.

Parámetros de ruta

:imei

Headers+ Agregar

×