# 添加并提审商品
接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
# 接口说明
# 接口英文名
addGoods
# 功能描述
调用此接口上传并提审需要直播的商品信息,审核通过后商品录入【小程序直播】商品库。
# 注意事项
- 开发者必须保存【商品ID】与【审核单ID】,如果丢失,则无法调用其他相关接口
- 调用额度:500次/一天
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxaapi/broadcast/goods/add?access_token=ACCESS_TOKEN
# 云调用
出入参和HTTPS调用相同,调用方式可查看云调用说明文档
接口方法为: openapi.liveBroadcast.goodsAdd
# 第三方调用
调用方式以及出入参和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 处理再填入 |
thirdPartyAppid | String | 否 | 当商品为第三方小程序的商品则填写为对应第三方小程序的appid,自身小程序商品则为'' |
# 返回参数含义
参数 | 说明 |
---|---|
goodsId | 商品ID |
auditId | 审核单ID |
# 调用示例
示例说明: HTTPS请求示例
# 请求数据示例
{
"goodsInfo": {
"coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",
"name":"TIT茶杯",
"priceType":1,
"price":99.5,
// "price2": 150.5, priceType为2或3时必填
"url":"pages/index/index"
}
}
# 返回数据示例
{
"goodsId": 51,
"auditId": 525022786,
"errcode": 0
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
200002 | 参数错误 | |
300002 | 名称长度不符合规则 | |
300003 | 价格输入不合规(如现价比原价大、传入价格非数字等) | |
300004 | 商品名称存在违规违法内容 | |
300006 | 图片上传失败(如:mediaID过期) | |
300007 | 线上小程序版本不存在该链接 | |
300021 | 商品添加成功,审核失败 | |
300018 | 商品图片尺寸过大 |