创建商品

SKU数组属性封装说明

当希望配置的商品在不同平台浏览下单时, 显示价格不同;
创建商品时需要开启多端配置enable_multi_config=1,此时可以针不同观看端创建不同的商品SKU;

注意

当商品开启端多配置后, 不可更改为单端商品; 反之单端商品同样不支持修改为多端商品, 请提前考量,创建匹配的商品;

示例

// 多端
{
    // 公共参数
    "app_key": "{{app_key}}",
    "signed_at": "{{signed_at}}",
    "sign_type": "{{sign_type}}",
    "sign": "{{sign}}",
    // 业务参数
    "third_goods_id": "SKU_1755307392",
    "name": "MacBook Air 13.6 2025",
    "images": [
        {
            "img_url": "https://cnstatic01.e.vhall.com/upload/webinars/spread-imgs/9b/95/9b958d5c6b9a66b97b463f6fe9deb42a2256.jpg",
            "is_cover": 1
        }
    ],
    "description": "苹果AI笔记本 , M4 (8+10核) 24G 512G 天空蓝",
    "enable_multi_config": 1,
    "sku": [
        {
            "third_goods_id": "SKU_1755307392",
            "buy_type": 2,
            "price": 5999.9,
            "discount_price": 199.9,
            "url": "https://www.bilibili.com",
            "shop_show": 0,
            "shop_url": "https://www.bilibili.com",
            "ext_attr": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        },
        {
            "third_goods_id": "SKU_1755307392",
            "buy_type": 3,
            "price": 96.99,
            "discount_price": 0.99,
            "scheme_template": "eshop.com://orders/suborder?type=1&skuId={{goods_id}}&skuNum={{quantity}}&hostId={{webinar_id}}&liveUrl={{watch_url}}",
            "qr_code_url": "https://www.bilibili.com",
            "ext_attr": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        },
        {
            "third_goods_id": "SKU_1755307392",
            "buy_type": 4,
            "mini_program_price": 88.99,
            "mini_program_discount_price": 0.99,
            "mini_program_jump_type": 0,
            "mini_program_id": "gh_9a54b795xxxx",
            "mini_program_app_id": "wx829e6fa92724xxxx",
            "mini_program_path": "/pages/jump/jump?colType=117&id=46035",
            "mini_program_ext": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        }
    ],
    "ext_data": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}"
}

请求参数

Header 参数

Body 参数application/json

示例

多端单端（网页嵌入）单端（App 嵌入）单端（微信小程序嵌入）

// 多端
{
    // 公共参数
    "app_key": "{{app_key}}",
    "signed_at": "{{signed_at}}",
    "sign_type": "{{sign_type}}",
    "sign": "{{sign}}",
    // 业务参数
    // "third_goods_id": "1755792064",
    "name": "MacBook Air 13.6 M4 2025",
    "images": [
        {
            "img_url": "https://cnstatic01.e.vhall.com/upload/webinars/spread-imgs/9b/95/9b958d5c6b9a66b97b463f6fe9deb42a2256.jpg",
            "is_cover": 1
        }
    ],
    "description": "苹果AI笔记本 , M4 (8+10核) 24G 512G 天空蓝",
    "enable_multi_config": 1,
    "sku": [
        {
            "third_goods_id": "1755792469",
            "buy_type": 2,
            "price": 5999.9,
            "discount_price": 199.9,
            "url": "https://www.bilibili.com",
            "shop_show": 0,
            "shop_url": "https://www.bilibili.com",
            "ext_attr": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        },
        {
            "third_goods_id": "1755792469",
            "buy_type": 3,
            "price": 96.99,
            "discount_price": 1.99,
            "scheme_template": "eshop.com://orders/suborder?type=1&skuId={{goods_id}}&skuNum={{quantity}}&hostId={{webinar_id}}&liveUrl={{watch_url}}",
            "qr_code_url": "https://www.bilibili.com",
            "ext_attr": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        },
        {
            "third_goods_id": "1755792469",
            "buy_type": 4,
            "mini_program_price": 88.99,
            "mini_program_discount_price": 1.99,
            "mini_program_jump_type": 0,
            "mini_program_id": "gh_9a54b795xxxx",
            "mini_program_app_id": "wx829e6fa92724xxxx",
            "mini_program_path": "/pages/jump/jump?colType=117&id=46035",
            "mini_program_ext": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
        }
    ],
    "ext_data": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}"
}

请求示例代码

Shell

Java

PHP

Python

SKU数组属性封装说明#

注意#

示例#

请求参数

请求示例代码

返回响应

SKU数组属性封装说明

注意

示例