添加并提审商品

添加并提审商品

接口应在服务器端调用，详细说明参见服务端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	商品图片尺寸过大