Consultar todos los productos

Descripción

Este método permite obtener la lista completa de productos disponibles o filtrarlos por tipo mediante un query parameter. Devuelve los códigos de operadora (SKU), montos, descripciones e imagen de ayuda visual de cada carrier.

URL API

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

Autenticación

Este endpoint se autentica mediante API Key.

Mecanismo	Header	Descripción
API Key	`x-api-key: {{apiKey}}`	Clave de API asignada a tu cuenta

Envía la clave en el header x-api-key en cada solicitud. No hay flujo de login previo. Solicita tu clave contactando al equipo de soporte Axios.

Situación	Código
Header `x-api-key` ausente	`401`
Clave inválida o no habilitada	`403`

Parámetros de Entrada

Parámetro	Tipo	Requerido	Descripción
`type`	string	No	Filtra por tipo de producto. Valores: `TAE`, `ACTIVACION`

Ejemplo de Uso

Sin filtro (todos los productos)

Endpoint:

GETapidevstore.axiosmobile.mx/v2/products

GET /v2/products HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}

Body : No aplica

Response Success

[
    {
        "carrier": "Usuario recarga contigo",
        "carrierCode": "203",
        "url": "https://api.eventamovil.mx/ayuda_visual/203.png",
        "prices": [
            {
                "title": "",
                "amount": "10",
                "message": "100 Mb, 250 min de voz y 125 SMS. Vigencia de 1 día",
                "days": "1",
                "data": "100"
            }
        ]
    },
    {
        "carrier": "Activación eSIM",
        "carrierCode": "500",
        "url": "https://api.eventamovil.mx/ayuda_visual/500.png",
        "prices": [
            {
                "title": "Plan Básico",
                "amount": "150",
                "message": "2 GB, 500 min de voz. Vigencia de 30 días",
                "days": "30",
                "data": "2048"
            }
        ]
    }
]

Con filtro por tipo

Endpoint:

GETapidevstore.axiosmobile.mx/v2/products?type=TAE

GET /v2/products?type=TAE HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}

Body : No aplica

Response Success

[
    {
        "carrier": "Usuario recarga contigo",
        "carrierCode": "203",
        "url": "https://api.eventamovil.mx/ayuda_visual/203.png",
        "prices": [
            {
                "title": "",
                "amount": "10",
                "message": "100 Mb, 250 min de voz y 125 SMS. Vigencia de 1 día",
                "days": "1",
                "data": "100"
            }
        ]
    }
]

Respuestas de Error

Tipo de producto no válido 400 Bad Request

{
    "error": "Tipo de producto no válido",
    "message": "\"INVALIDO\" no es un tipo válido. Valores permitidos: TAE, ACTIVACION"
}

Error interno 500 Internal Server Error

{
    "error": "Error interno del servidor",
    "message": "Ocurrió un error al procesar los productos.",
    "details": "..."
}

429 — Demasiadas peticiones Client Error

Se retorna cuando se supera el límite de 60 peticiones por minuto por usuario (tu API Key).

{ "error": "Too many requests, please try again later" }

Parámetros de Salida

Parámetro	Tipo	Descripción
`carrier`	string	Nombre del producto
`carrierCode`	string	Código de la operadora (SKU)
`url`	string	URL de la imagen de ayuda visual del carrier
`prices`	array	Lista de ofertas disponibles para este carrier
`prices[].title`	string	Título de la oferta (puede estar vacío)
`prices[].amount`	string	Monto de la oferta
`prices[].message`	string	Descripción detallada de la oferta
`prices[].days`	string	Días de vigencia
`prices[].data`	string	MB de datos incluidos

Estos son los parámetros que recibirás al realizar la solicitud. Asegúrate de manejar los datos correctamente en tu aplicación.

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/products
Consultar todos los productos — Requiere API Key en el header x-api-key. Deja vacío el query param para obtener todos, o filtra por TAE / ACTIVACION.
Query Parameters
Headers