# 更新商品
接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
# 接口说明
# 接口英文名
updateGoodsinfo
# 功能描述
调用此接口可以更新商品信息,审核通过的商品仅允许更新价格类型与价格,审核中的商品不允许更新,未审核的商品允许更新所有字段, 只传入需要更新的字段。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxaapi/broadcast/goods/update?access_token=ACCESS_TOKEN
# 云调用
出入参和HTTPS调用相同,调用方式可查看云调用说明文档
接口方法为: openapi.liveBroadcast.goodsUpdate
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:52
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数含义
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
coverImgUrl | String | 是 | 填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: New_temporary_materials;图片规则:图片尺寸最大300像素*300像素; |
name | String | 是 | 商品名称,最长14个汉字,1个汉字相当于2个字符 |
priceType | Number | 是 | 价格类型,1:一口价(只需要传入price,price2不传) 2:价格区间(price字段为左边界,price2字段为右边界,price和price2必传) 3:显示折扣价(price字段为原价,price2字段为现价, price和price2必传) |
price | Number | 是 | 数字,最多保留两位小数,单位元 |
price2 | Number | 否 | 数字,最多保留两位小数,单位元 |
url | String | 是 | 商品详情页的小程序路径,路径参数存在 url 的,该参数的值需要进行 encode 处理再填入 |
goodsId | Number | 是 | 商品ID |
thirdPartyAppid | String | 否 | 当商品为第三方小程序的商品则填写为对应第三方小程序的appid,自身小程序商品则为'' |
# 返回参数
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"goodsInfo": {
// 需要更新哪个字段就传入哪个字段,goodsId 必传
"coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",
"name":"TIT茶杯",
"priceType":1,
"price":99.5,
// "price2": 150.5, priceType为2或3时必填
"url": "pages/index/index",
"goodsId": 9
}
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok"
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
200002 | 参数错误 | |
300002 | 名称长度不符合规则 | |
300003 | 价格输入不合规(如现价比原价大、传入价格非数字等) | |
300006 | 图片上传失败(如:mediaID过期) | |
300007 | 线上小程序版本不存在该链接 | |
300010 | 商品审核状态不对(如商品审核中) | |
300011 | 操作非法(API不允许操作非API创建的商品) | |
300015 |