# 添加并提审商品

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