Product Create API 文档

商品-创建

接口信息

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

认证

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

请求参数 (Body - JSON)

顶层字段

product 字段详表

short_description_json 结构说明

每项格式：

{
    "text": "默认文本",
    "lang_params": {
        "text": {
            "cn": "中文翻译"
        }
    }
}

productattr_info 字段详表

images 字段详表

新增时不需要传 id，系统会自动生成。

videos 字段详表

新增时不需要传 id。

options 字段详表

单规格产品为空，多规格产品必填。新增时不需要传 id。

variants 字段详表

单规格产品数组只有一个子项。新增时不需要传 id。

tags 字段详表

新增时传 id: ""（空字符串）。

glasses 字段详表

mergeimages 字段详表

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/product/create' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product": {
        "spu": "3232323",
        "title": "Morden Lighting Nordic Fabric Shade Black White Floor Lamp",
        "sub_title": "Morden Lighting Nordic Fabric Shade Black White Floor Lamp subtitle",
        "body_html": "...（HTML 模板装修内容，详见下方 body_html 说明）...",
        "status": 1,
        "is_tax": 1,
        "payafteruse": 1,
        "virtual_sales_count": "33",
        "type": 2,
        "vendor": "Lighting Made",
        "variant_need_image": "1",
        "variant_show_image": 3,
        "inventory_police": "1",
        "inventory_police_type": 1,
        "meta_is_edit": "2",
        "meta_title": "Morden Lighting Nordic Fabric Shade Black White Floor Lamp",
        "meta_keywords": "Morden Lighting",
        "meta_description": "Morden Lighting Nordic Fabric Shade Black White Floor Lamp, ...",
        "feed_description": "google feed description",
        "feed_title": "google feed title",
        "handle": "morden-lighting-nordic-fabric-shade-black-white-floor-lamp",
        "translate_type": 3,
        "google_product_category": 111,
        "google_product_type_id": "light",
        "description_json": "（Object，模板装修 JSON 数据，包含 collage-tabs 和 brand-list 两个 section，详见下方说明）",
        "description_json_status": 1,
        "params_json": [],
        "params_json_status": 2,
        "short_description_json": [
            {
                "text": "Morden Lighting Nordic Fabric Shade Black White Floor Lamp",
                "lang_params": {
                    "text": {
                        "cn": "摩登照明北欧布艺灯罩黑白落地灯"
                    }
                }
            },
            {
                "text": "Nordic Fabric Shade Black White Floor Lamp",
                "lang_params": {
                    "text": {
                        "cn": "北欧风格黑白布艺灯罩落地灯"
                    }
                }
            }
        ],
        "template_type": "product",
        "variant_need_note": "1"
    },
    "productattr_info": [],
    "images": [
        {
            "src": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "position": 1,
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        },
        {
            "src": "/product/15/image/2026/04/28/f6d04b41c743455948ed5dfea357a53e.jpg",
            "position": 2,
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        },
        {
            "src": "/product/15/image/2026/04/28/858278fe4f6d493ece46810169a4df21.jpg",
            "position": 3,
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        }
    ],
    "videos": [
        {
            "src": "https://cloud.video.taobao.com/play/u/2206786293671/p/1/e/6/t/1/453995116363.mp4",
            "position": 1,
            "alt": ""
        }
    ],
    "addition_group_id": 73,
    "variantremark_id": 9,
    "groupbuy_id": 12,
    "collection_ids": [342, 343],
    "label_ids": [],
    "options": [
        {
            "name": "Color",
            "position": 1,
            "items": ["grey", "white"]
        },
        {
            "name": "Size",
            "position": 2,
            "items": ["L", "M"]
        }
    ],
    "variants": [
        {
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "sku": "3232323-grey-L-1010805",
            "barcode": "1111",
            "image": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "qty": 8999,
            "option1": "grey",
            "option2": "L",
            "option3": "",
            "weight": "11",
            "weight_unit": "kg",
            "note": "grey l",
            "buy_min_count": 1,
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ]
        },
        {
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "sku": "3232323-grey-M-1010806",
            "barcode": "2222",
            "image": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "qty": 8999,
            "option1": "grey",
            "option2": "M",
            "option3": "",
            "weight": "11",
            "weight_unit": "kg",
            "note": "grey m",
            "buy_min_count": 1,
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ]
        },
        {
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "sku": "3232323-white-L-1010807",
            "barcode": "3333",
            "image": "/product/15/image/2026/04/28/858278fe4f6d493ece46810169a4df21.jpg",
            "qty": 8999,
            "option1": "white",
            "option2": "L",
            "option3": "",
            "weight": "11",
            "weight_unit": "kg",
            "note": "white l",
            "buy_min_count": 1,
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ]
        },
        {
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "sku": "3232323-white-M-1010808",
            "barcode": "4444",
            "image": "/product/15/image/2026/04/28/858278fe4f6d493ece46810169a4df21.jpg",
            "qty": 8999,
            "option1": "white",
            "option2": "M",
            "option3": "",
            "weight": "11",
            "weight_unit": "kg",
            "note": "white m",
            "buy_min_count": 1,
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ]
        }
    ],
    "glasses": {
        "button_type": 1,
        "distance_min": "11",
        "distance_max": "99",
        "sex": {
            "value": "sex",
            "language": {"cn": "性别"}
        },
        "lens_type": {
            "value": "style",
            "language": {"cn": "类型"}
        },
        "material": {
            "value": "type",
            "language": {"cn": "材料"}
        }
    },
    "mergeimages": [],
    "tags": [
        {"title": "white", "id": ""},
        {"title": "black", "id": ""}
    ]
}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "product_id": 4693
    },
    "message": "success"
}

返回字段说明

错误响应

{
    "code": 100701001,
    "message": "error message"
}

错误码说明

/api/skill/product/update 和 /api/skill/product/create 参数结构几乎一致，主要区别：

注意事项

1. body_html 为商品详情页的 HTML 模板装修内容，与 description_json 对应
2. 变体的 image 字段必须已存在于 images 数组中，否则无法保存
3. images[].position 必须从 1 开始连续递增，position=1 的图片为主图
4. options[].position 只能为 1、2、3，且每个 option 的 position 不可重复
5. variants 中的 option1/2/3 值必须与对应 position 的 options[].items 中的值匹配
6. wholesale_price 为变体的批发价格数组，每个元素包含 qty（起批数量）和 price（批发单价）
7. weight_unit 支持 g、kg、lb、oz 四种单位
8. description_json 为模板装修数据（Object），非数组；description_json_status 为 1 时才生效
9. short_description_json 每项包含 text（默认文本）和 lang_params.text.{语言}（多语言翻译）
10. 新增时所有实体的 id 字段均不需要传（或传空），系统会自动生成