更新商品
开发中
POST
https://saas-open.vhall.com/v3/goods/good/update
SKU数组属性封装说明
创建商品时需要开启多端配置
enable_multi_config=1,此时可以针不同观看端创建不同的商品SKU;当商品开启端多配置后, 不可更改为单端商品; 反之单端商品同样不支持修改为多端商品, 请提前考量,创建匹配的商品;
平台购买商品配置字段
| 字段 | 类型 | 说明 |
|---|---|---|
| buy_type | integer | 1=平台购买 |
| price | number | 平台购买-商品价格 |
| discount_price | number | 平台购买-商品优惠价格 |
| shop_show | integer | 平台购买-是否展示店铺按钮 |
| shop_url | string | 平台购买-店铺跳转地址 |
外链购买商品配置字段
| 字段 | 类型 | 说明 |
|---|---|---|
| buy_type | integer | 2=外链购买 |
| price | number | 外链购买-商品价格 |
| discount_price | number | 外链购买-商品优惠价格 |
| shop_show | integer | 外链购买-是否展示店铺按钮 |
| shop_url | string | 外链购买-店铺跳转地址 |
| url | string | 外链购买-购买跳转地址 |
| ext_attr | string | 外链购买-透传扩展字段 |
APP购买商品配置字段
| 字段 | 类型 | 说明 |
|---|---|---|
| buy_type | integer | 3=APP购买 |
| price | number | APP购买-商品价格 |
| discount_price | number | APP购买-商品优惠价格 |
| shop_show | integer | APP购买-是否展示店铺按钮 |
| shop_url | string | APP购买-店铺跳转地址 |
| ext_attr | string | APP购买-透传扩展字段 |
| third_goods_id | string | APP购买-三方商品编号 |
| scheme_template | string | APP购买-跳转模板 |
| qr_code_url | string | APP购买-引导下载二维码地址 |
小程序购买商品配置字段
| 字段 | 类型 | 说明 |
|---|---|---|
| buy_type | integer | 4=小程序购买 |
| mini_program_price | number | 小程序购买-商品价格 |
| mini_program_discount_price | number | 小程序购买-商品优惠价格 |
| shop_show | integer | 小程序购买-是否展示店铺按钮 |
| shop_url | string | 小程序购买-店铺跳转地址 |
| ext_attr | string | 小程序购买-透传扩展字段 |
| mini_program_jump_type | string | 小程序购买-跳转方式,默认0, 小程序内跳转 |
| mini_program_id | string | 小程序购买-小程序ID |
| mini_program_app_id | string | 小程序购买-小程序appid |
| mini_program_path | string | 小程序购买-购买跳转地址 |
"sku": [
{
"buy_type": 1,
"price": 99.99,
"discount_price": 0.99,
"shop_show": 0,
"shop_url": "https://www.eshop.com/shop/6666",
"ext_attr": ""
},
{
"buy_type": 2,
"price": 99.99,
"discount_price": 0.99,
"url": "https://www.eshop.com",
"shop_show": 0,
"shop_url": "https://www.eshop.com/shop/6666",
"ext_attr": ""
},
{
"buy_type": 3,
"third_goods_id": "sku_121883138",
"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://eshop.com/app_downlod.png",
"shop_url": "eshop.com://shop/index",
"shop_show": 0,
"ext_attr": ""
},
{
"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,回传上层\"}"
}
]请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
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": "sku1753972723",
// "goods_id":110369,
// "name": "MacBook Pro 14寸 M4Pro 2025",
// "images": [
// {
// "img_url": "https://cnstatic01.e.vhall.com/upload/webinars/spread-imgs/9b/95/9b958d5c6b9a66b97b463f6fe9deb42a2256.jpg",
// "is_cover": 1
// }
// ],
// "description": "转为设计打造",
// "enable_multi_config": 0,
// "buy_type": 2,
// "url": "https://www.baidu.com",
// "shop_show": 0,
// "shop_url": "https://www.baidu.com",
// "price": 22.6,
// "discount_price": 5.5
// }
// 多端购买
{
"app_key": "75844ad7a2a5f2b421c04a125b197996",
"signed_at": "{% mock 'timestamp' , 's' %}",
"sign_type": "0",
"sign": "{{sign}}",
// "third_goods_id": "sku121883138",
"goods_id": 110350,
"name": "国宝大熊猫",
"description": "大熊猫花花",
"enable_multi_config": 1,
"images": [
{
"img_url": "https://cnstatic01.e.vhall.com/upload/webinars/spread-imgs/9b/95/9b958d5c6b9a66b97b463f6fe9deb42a2256.jpg",
"is_cover": 1
}
],
"ext_data": "{\"flag\":111,\"msg\":\"透传内容,通过接口等回传\"}",
"sku": [
{
"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": ""
},
{
"buy_type": 3,
"third_goods_id": "sku_121883138",
"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",
"shop_url": "https://www.bilibili.com",
"shop_show": 0,
"ext_attr": ""
},
{
"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,回传上层\"}"
}
]
}'响应示例响应示例
{
"code": 200,
"msg": "success",
"data": null,
"trace_id": "8f6da5b3-529b-495e-866c-f6215342d145"
}请求参数
Header 参数
Body 参数application/json
返回响应
修改于 2025-08-10 05:29:41