创建商品
POST
https://saas-open.vhall.com/v3/goods/good/create
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
返回响应
请求示例请求示例
Shell
Java
Go
PHP
curl --location --request POST 'https://saas-open.vhall.com/v3/goods/good/create' \
--header 'platform;' \
--header 'Content-Type: application/json' \
--data-raw '// 多端
{
// 公共参数
"app_key": "75844ad7a2a5f2b421c04a125b197996",
"signed_at": "{% mock 'timestamp' , 's' %}",
"sign_type": "0",
"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\":\"透传内容,通过接口等回传\"}"
}'响应示例响应示例
{
"trace_id": "",
"code": 0,
"msg": "",
"data": {
"goods_id": 0
}
}修改于 2025-09-09 05:49:38