1.评论管理
评论管理功能,与单用户禁言。之前只支持整个直播间禁止评论,目前已上线通过小助手对单个用户禁言,而且可以设置敏感词,有敏感词的评论将不出现在评论列表(官方已经添加了常见的禁用词)。
2.创建直播间
该接口仅供商家后台调用,调用限额 1 万次/天,1万次我的天!!!然而当天貌似只能创建50个直播间,后期做到无限制就好了,哪怕收费也可以滴!
3.商品添加并提审
接口说明
调用此接口上传并提审需要直播的商品信息,审核通过后商品录入【小程序直播】商品库
注意:开发者必须保存【商品ID】与【审核单ID】,如果丢失,则无法调用其他相关接口
调用频率
调用额度:500次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/add?access_token=access_token
请求参数示例: json
{
"goodsInfo": {
"coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",
"name":"TIT茶杯",
"priceType":1,
"price":"111",
"price2":"",
"url":"pages/index/index"
}
}
请求参数含义
参数说明coverImgUrl填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html);图片规则:图片尺寸最大300像素*300像素;name商品名称,最长17个汉字,1个汉字相当于2个字符priceType价格类型,1:一口价,2:价格区间,3:显示折扣价;1:一口价,只需要传入price,price2不传;2:价格区间,price字段为左边界,price2字段为右边界,price和price2必传。3:折扣价,price字段为原价,price2字段为现价, price和price2必传price数字,最多保留两位小数,单位元price2数字,最多保留两位小数,单位元url商品详情页的小程序路径
正确返回示例
{
"goodsId": 51,
"auditId": 525022786,
"errcode": 0
}
返回参数含义
参数说明goodsId商品IDauditId审核单ID
4.撤回审核
接口说明
调用此接口,可撤回直播商品的提审申请,消耗的提审次数不返还
调用频率
调用额度:500次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/resetaudit?access_token=access_token
请求参数示例: json
{
"auditId": 525022184,
"goodsId": 9
}
请求参数含义
参数说明goodsId商品IDauditId审核单ID
正确返回示例
{
"errcode": 0
}
5.重新提交审核
接口说明
调用此接口可以对已撤回提审的商品再次发起提审申请
调用频率
调用额度:500次/一天(与接口1共用500次限制)
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/audit?access_token=access_token
请求参数示例: json
{
"goodsId": 9
}
请求参数含义
参数说明goodsId商品ID
正确返回示例
{
"errcode": 0,
"auditId": 525022184
}
返回参数含义
参数说明auditId审核单ID
6.删除商品
接口说明
调用此接口,可删除【小程序直播】商品库中的商品,删除后直播间上架的该商品也将被同步删除,不可恢复;
调用频率
调用额度:1000次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/delete?access_token=access_token
请求参数示例: json
{
"goodsId": 9
}
请求参数含义
参数说明goodsId商品ID
返回参数
{
"errcode": 0,
}
7.更新商品
接口说明
调用此接口可以更新商品信息,审核通过的商品仅允许更新价格类型与价格,审核中的商品不允许更新,未审核的商品允许更新所有字段, 只传入需要更新的字段。
调用频率
调用额度:1000次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/update?access_token=access_token
请求参数示例: json
{
"goodsInfo": {
// 需要更新哪个字段就传入哪个字段,goodsId 必传
"coverImgUrl": "ZuYVNKk9sMP1X4m7FXdcDCKra251KDZTjS502UTV7gwalgLZXcrOhG6oNYX6c7AR",
"name":"TIT茶杯",
"priceType":1,
"price": "1111",
"price2":"",
"url": "pages/index/index",
"goodsId": 9
}
}
请求参数含义
参数说明coverImgUrl填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html);图片规则:图片尺寸最大300像素*300像素;name商品名称,最长17个汉字,1个汉字相当于2个字符priceType价格类型,1:一口价,2:价格区间,3:显示折扣价;1:一口价,只需要传入price,price2不传;2:价格区间,price字段为左边界,price2字段为右边界,price和price2必传。3:折扣价,price字段为现价,price2字段为原价, price和price2必传price数字,最多保留两位小数,单位元price2数字,最多保留两位小数,单位元url商品详情页的小程序路径goodsId商品ID
返回参数
{
"errcode": 0,
}
8.获取商品状态
接口说明
调用此接口可获取商品的信息与审核状态
调用频率
调用额度:1000次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxa/business/getgoodswarehouse?access_token=access_token
请求参数示例: json
{
"goods_ids": [1]
}
请求参数含义
参数说明goods_ids商品ID
返回参数
{
"errcode":0,
"errmsg":"ok",
"goods":
[
{
"goods_id":9,
"cover_img_url":"xxxx",
"name":"xxxxx"
"price":12300,
"url":"xxxxxxx",
"price_type":1,
"price2":0,
"audit_status":1,
"third_party_tag":0
}
],
"total":0
}
返回参数含义
参数说明goods_id商品IDname商品名称priceType1:一口价,此时读price字段,2:价格区间,此时price字段为左边界,price2字段为右边界,3:折扣价,此时price字段为原价,price2字段为现价;price价格左区间,单位“元”price2价格右区间,单位“元”audit_status0:未审核,1:审核中,2:审核通过,3审核失败third_party_tag2:表示是为api添加商品,否则不是api添加商品
9.获取商品列表
接口说明
调用此接口可获取商品列表
调用频率
调用额度:10000次/一天
请求方法
GET
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/goods/getapproved?access_token=[access_token]
URL query 参数
参数说明offset分页条数起点limit分页大小,默认30,不超过100status商品状态,0:未审核。1:审核中,2:审核通过,3:审核驳回
返回参数
{
"errcode":0,
"total":68,
"goods":
[
{
"goodsId":9,
"coverImgUrl":"xxxx",
"name":"xxxxx"
"price":12300,
"url":"xxxxxxx",
"priceType":1,
"price2":0,
"thirdPartyTag":0
}
]
}
返回参数含义
参数说明goodsId商品IDname商品名称priceType1:一口价,此时读price字段,2:价格区间,此时price字段为左边界,price2字段为右边界,3:折扣价,此时price字段为原价,price2字段为现价;price价格左区间,单位“元”price2价格右区间,单位“元”thirdPartyTag1,2:表示是为api添加商品,否则是再MP添加商品total商品数量url商品小程序路径coverImgUrl商品图片链接
10.往指定直播间导入已入库商品
接口说明
调用此接口往指定直播间导入已入库的商品
调用频率
调用额度:10000次/一天
请求方法
POST
请求URL
https://api.weixin.qq.com/wxaapi/broadcast/room/addgoods?access_token=
请求参数示例: json
{
"ids": [9,11], "roomId":223
}
请求参数含义
参数说明ids数组列表,可传入多个,里面填写 商品IDroomId房间id
返回参数
{
"errcode":0,
}
想咨询一下2个问题
1.获取商品状态接口的请求参数是商品数组,这个接口一次性最大支持获取多少个商品的状态?
2.商品添加审核接口,如果商品已存在(也就是商品链接是同一个),接口返回是成功添加2条,还是失败不添加?,还是成功不添加?