Product List API 文档

接口信息

• 接口地址: {your-site-url}/api/skill/product/list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• Content-Type: application/json
• 说明: 此接口为查询接口，用于获取商品列表

认证

请求头中需要携带 skill-access-token：

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/product/list?pageNum=1&pageSize=20&title=black&status=1&collection_ids=343,32&tags=red,black&tags_type=and&id_begin=1000&id_end=5000&created_at_begin=2026-01-01 00:00:00&created_at_end=2026-05-01 23:59:59' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 4625,
                "handle": "morden-lighting-nordic-white-black-lamp-shade-floor-lamp-wooden-support-standing-light",
                "spu": "7218747113643",
                "title": "Nordic White Black Lamp Floor Lamp Wooden Standing",
                "sub_title": "",
                "body_html": "...",
                "meta_title": "Nordic White Black Lamp Floor Lamp Wooden Standing",
                "meta_keywords": "",
                "meta_description": "...",
                "status": 1,
                "availability": 1,
                "type": 2,
                "vendor": "Lighting Made",
                "qty": 198,
                "created_at": "2026-02-08 10:35:42",
                "updated_at": "2026-05-05 11:10:19",
                "inventory_police": 1,
                "inventory_police_type": 1,
                "variant_need_image": 1,
                "variant_need_note": 1,
                "variants": [
                    {
                        "id": 42432,
                        "product_id": 4625,
                        "title": "White",
                        "price": "470.00",
                        "compare_at_price": "500.00",
                        "cost_price": "0.00",
                        "wholesale_price": [
                            { "qty": 2, "price": "38.99" },
                            { "qty": 5, "price": "18.99" }
                        ],
                        "sku": "LM4540066",
                        "gram": 2267,
                        "position": 0,
                        "barcode": "",
                        "image_id": 30233,
                        "qty": 98,
                        "option1": "White",
                        "option2": "",
                        "option3": "",
                        "weight": "5.00",
                        "weight_unit": "lb",
                        "sale_count": 0,
                        "note": "",
                        "remote_id": 0,
                        "source_id": "",
                        "image": "https://cdn12.fecmall.com/product/15/image/2026/02/08/1e0c57ae313ecb06f730ee2e27f31c42.jpg"
                    }
                ],
                "options": [
                    {
                        "id": 5135,
                        "product_id": 4625,
                        "name": "Lampshade Color",
                        "position": 1,
                        "items": ["White", "Black"]
                    }
                ],
                "images": [
                    {
                        "id": 30232,
                        "product_id": 4625,
                        "position": 1,
                        "src": "https://cdn12.fecmall.com/product/15/image/2026/02/08/90667114713397b934d471526f73bfd4.jpg",
                        "alt": "",
                        "width": 800,
                        "height": 800,
                        "ratio": "1.00"
                    }
                ],
                "collectionIds": [343, 327, 322, 344, 345],
                "tagIds": [
                    {
                        "product_id": 4625,
                        "tag_id": 10,
                        "tag": { "title": "red", "id": 10, "first_letter": "r" }
                    }
                ]
            }
        ],
        "total": 1,
        "pageSize": 20,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

data 顶层字段

data.list 子项 - 商品基本信息

data.list 子项 - 商品状态/配置

data.list 子项 - variants（产品变体/规格）

当为单规格产品时，该数组只有一个子项。

wholesale_price 子字段

wholesale_price 是一个数组，每个元素包含：

示例：

"wholesale_price": [
    { "qty": 2, "price": "38.99" },
    { "qty": 5, "price": "18.99" }
]

data.list 子项 - options（产品规格定义）

单规格产品为空，多规格产品不为空。

data.list 子项 - images（产品图片）

data.list 子项 - collectionIds

data.list 子项 - tagIds

注意事项

1. 所有请求参数均为选填
2. collection_ids 多个值时是或关系，会搜索出存在于这些专辑中的全部商品
3. tags 配合 tags_type 使用：tags_type=or（默认）为或关系，tags_type=and 为并关系
4. id_begin 和 id_end 可单独或组合使用，用于按商品 ID 区间过滤
5. created_at_begin 和 created_at_end 可单独或组合使用，用于按创建时间区间过滤，时间格式必须为 YYYY-MM-DD HH:mm:ss