Product Collection Create API 文档

商品专辑创建

接口信息

• 接口地址: {your-site-url}/api/skill/product-collection/create
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于创建商品专辑，支持手动专辑（指定商品 ID）和自动专辑（通过规则条件匹配）

认证

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

请求参数 (Body - JSON)

基础字段

图片字段

自动专辑字段（type=2 时使用）

automated_rules 子项

每个规则对象包含三个属性：

{
    "key": "tag",
    "type": "is_equal_to",
    "value": "red"
}

支持的 key（商品属性）

在 MySQL 模式下只支持 tag 属性。

各 key 支持的 type 条件

type 可选值说明

请求示例

创建自动专辑（按 tag 匹配）

curl --location --request POST '{your-site-url}/api/skill/product-collection/create' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": 2,
    "handle": "product-collection-title",
    "title": "product collection title",
    "body_html": "product collection description",
    "meta_title": "product collection title",
    "meta_keywords": "keywords product collection title",
    "meta_description": "meta product collection title",
    "image": "",
    "width": "",
    "height": "",
    "ratio": "",
    "image_h5": "",
    "width_h5": "",
    "height_h5": "",
    "ratio_h5": "",
    "automated_rules": [
        {
            "key": "tag",
            "type": "is_equal_to",
            "value": "red"
        }
    ],
    "automated_type": 1,
    "template_type": "collection"
}'

创建自动专辑（多条件匹配）

curl --location --request POST '{your-site-url}/api/skill/product-collection/create' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": 2,
    "title": "Price Range Collection",
    "automated_type": 2,
    "automated_rules": [
        {
            "key": "price",
            "type": "is_greater_than",
            "value": "10"
        },
        {
            "key": "price",
            "type": "is_less_than",
            "value": "100"
        }
    ]
}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "shop_id": 15,
        "type": 2,
        "handle": "product-collection-title-w4xhk02y",
        "title": "product collection title",
        "body_html": "product collection description",
        "meta_is_edit": 2,
        "meta_title": "product collection title",
        "meta_keywords": "keywords product collection title",
        "meta_description": "meta product collection title",
        "image": "",
        "image_h5": "",
        "width": 0,
        "height": 0,
        "ratio": 0,
        "width_h5": 0,
        "height_h5": 0,
        "ratio_h5": 0,
        "sort_order": 0,
        "automated_type": 1,
        "translate_type": 3,
        "remote_id": "",
        "custom_url_info": "",
        "template_type": "collection",
        "automated_rules": [
            {
                "key": "tag",
                "type": "is_equal_to",
                "value": "red"
            }
        ],
        "created_at": "2026-05-09 15:46:39",
        "updated_at": "2026-05-09 15:46:39",
        "id": 352
    },
    "message": "success"
}

返回字段说明

注意事项

1. type 为必填，1 手动 / 2 自动
2. 手动专辑（type=1）需配合添加商品到专辑的 API 使用
3. 自动专辑（type=2）通过 automated_rules 规则自动匹配商品
4. handle 如果不传，系统会自动生成；如果传入但已存在，会在末尾追加随机字符
5. MySQL 模式下仅 tag 属性可用；Typesense 引擎模式支持所有属性