更新商品
POST
https://saas-open.vhall.com/v3/goods/good/update
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",
"goods_id": 113518,
"name": "2025 MacBook Air 13.6",
"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/update' \
--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",
"goods_id": 115733,
"name": "迪迦 . 奥特曼",
"images": [
{
"img_url": "https://cnstatic01.e.vhall.com/upload/webinars/spread-imgs/9b/95/9b958d5c6b9a66b97b463f6fe9deb42a2256.jpg",
"is_cover": 1
}
],
"description": "专为设计而生",
"enable_multi_config": 1,
"sku": [
{
// "third_goods_id": "SKU_1755307392",
"buy_type": 2,
"price": 99.99,
"discount_price": 0.99,
"url": "https://www.bilibili.com",
"shop_show": 0,
"shop_url": "https://www.bilibili.com",
"ext_attr": "{\"flag\":111,\"msg\":\"透传内容,通过postmssage,回传上层\"}"
},
{
// "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\":\"透传内容,通过postmssage,回传上层\"}"
},
{
// "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\":\"透传内容,通过postmssage,回传上层\"}"
}
],
"ext_data": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}"
}'响应示例响应示例
{
"code": 200,
"msg": "success",
"data": null,
"trace_id": "8f6da5b3-529b-495e-866c-f6215342d145"
}修改于 2025-09-09 05:49:36