Obtener lista de productos

POST

/api/v1/products/list

Devuelve la lista de productos asignados.

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200OK

application/json

successful operation

Bodyapplication/json

🟠400Solicitud Incorrecta

🟠401No Autorizado

🟠404Registro No Encontrado

🔴500Error del Servidor

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location '/api/v1/products/list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "data": {
      "search": "xxx",
      "categoryId": 1,
      "limit": 10000
  }
}'

Ejemplo de Respuesta

200 - Éxito

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "Categories": [
            {
                "id": 3014,
                "name": "Favoritos",
                "image": "/images/categories/favorite.svg",
                "sort": 1001,
                "options": {
                    "categoryTitle": "Favoritos",
                    "view": {
                        "show": "products",
                        "showType": "cards"
                    }
                },
                "Products": []
            },
            {
                "id": 1,
                "name": "Recargas",
                "image": "/images/categories/topup.svg",
                "sort": 1,
                "options": {
                    "categoryTitle": "Multiproducto",
                    "view": {
                        "show": "products",
                        "showType": "cards"
                    }
                },
                "Products": [
                    {
                        "id": 10000001,
                        "name": "Movistar",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/movistar.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10000002,
                        "name": "Tuenti",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/tuenti.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10000003,
                        "name": "CNT",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/cnt.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10000004,
                        "name": "Akimovil",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/akimovil.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10000005,
                        "name": "Maxiplus",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/maxiplus.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10000000,
                        "name": "Claro",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/claro.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 1,
                        "isFavorite": false,
                        "City": null
                    }
                ]
            },
            {
                "id": 2,
                "name": "Paquetes",
                "image": "/images/categories/package.svg",
                "sort": 2,
                "options": {
                    "categoryTitle": "Multiproducto",
                    "view": {
                        "show": "products",
                        "showType": "cards"
                    }
                },
                "Products": [
                    {
                        "id": 10003222,
                        "name": "Paquemaxi",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/maxiplus.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10003202,
                        "name": "Paquecnt",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/cnt.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10003190,
                        "name": "Paquetuenti",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/tuenti.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10003146,
                        "name": "Paquemovistar",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/movistar.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10003132,
                        "name": "Paqueclaro",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/claro.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    },
                    {
                        "id": 10003213,
                        "name": "Paqueaki",
                        "alert": {},
                        "activationProcess": null,
                        "image": "/images/akimovil.webp",
                        "price": null,
                        "nit": null,
                        "earnings": null,
                        "categoryId": 2,
                        "isFavorite": false,
                        "City": null
                    }
                ]
            }
        ]
    },
    "_channel": "web"
}

Modificado en 2026-02-04 19:57:34

Colombia

Obtener producto por Id