Product Collection Update API 文档

更新专辑

接口信息

• 接口地址: {your-site-url}/api/skill/product-collection/update
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于更新商品专辑

认证

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

与创建专辑的区别

其余字段与创建专辑一致。

请求参数 (Body - JSON)

基础字段

图片字段

自动专辑字段（仅当专辑 type=2 时有效）

automated_rules 子项

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

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

支持的 key（商品属性）

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

各 key 支持的 type 条件

type 可选值说明

请求示例

cURL（更新手动专辑）

curl --location --request POST '{your-site-url}/api/skill/product-collection/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 363,
    "title": "Sea Sand Dress",
    "handle": "sea-sand-dress",
    "body_html": "<p>Discover our Sea Sand Dress collection...</p>",
    "meta_title": "Sea Sand Dress - Beach Dresses & Summer Resort Wear",
    "meta_keywords": "sea sand dress, beach dress, summer dress",
    "meta_description": "Shop the Sea Sand Dress collection...",
    "image": "/category/15/image/2026/05/11/e1d10f74dbff13c7ae596a008bc5f876.jpg",
    "image_h5": "/category/15/image/2026/05/11/f5421ec4d394443bff4312de9c82817f.jpg",
    "automated_rules": [],
    "template_type": ""
}'

更新自动专辑规则

curl --location --request POST '{your-site-url}/api/skill/product-collection/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 352,
    "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": {
        "id": 363,
        "shop_id": 15,
        "type": 1,
        "handle": "sea-sand-dress",
        "title": "Sea Sand Dress",
        "body_html": "<p>Discover our Sea Sand Dress collection...</p>",
        "meta_is_edit": 2,
        "meta_title": "Sea Sand Dress - Beach Dresses & Summer Resort Wear",
        "meta_keywords": "sea sand dress, beach dress, summer dress",
        "meta_description": "Shop the Sea Sand Dress collection...",
        "image": "/category/15/image/2026/05/11/e1d10f74dbff13c7ae596a008bc5f876.jpg",
        "image_h5": "/category/15/image/2026/05/11/f5421ec4d394443bff4312de9c82817f.jpg",
        "width": 0,
        "height": 0,
        "ratio": 0,
        "width_h5": 0,
        "height_h5": 0,
        "ratio_h5": 0,
        "sort_order": 0,
        "automated_type": 0,
        "translate_type": 3,
        "remote_id": "",
        "custom_url_info": [],
        "template_type": "",
        "automated_rules": [],
        "created_at": "2026-05-11 12:12:20",
        "updated_at": "2026-05-11 12:12:20"
    },
    "message": "success"
}

返回字段说明

注意事项

1. id 为必填，指定要更新的专辑
2. 专辑 type（手动/自动）创建后不可更改，更新时无需传入
3. handle 如果不传则沿用原有值；如果传入且与其他专辑冲突，会自动追加随机后缀
4. 手动专辑（type=1）的 automated_rules 传空数组即可
5. MySQL 模式下仅 tag 属性可用；Typesense 引擎模式支持所有属性