获取商品列表

获取商品列表

接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

接口说明

接口英文名

getGoodsInfo

功能描述

该接口用户获取不同审核状态的商品信息。

注意事项

调用额度:10000次/一天

调用方式

HTTPS 调用

GET https://api.weixin.qq.com/wxaapi/broadcast/goods/getapproved?access_token=ACCESS_TOKEN 

云调用

  • 出入参和HTTPS调用相同,调用方式可查看云调用说明文档
  • 接口方法为: openapi.liveBroadcast.goodsList

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同
  • 该接口所属的权限集id为:52
  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

URL query 参数

参数 类型 必填 说明
offset Number 分页条数起点
limit Number 分页大小,默认30,不超过100
status Number 商品状态,0:未审核。1:审核中,2:审核通过,3:审核驳回

返回参数含义

参数 说明
total 商品数量
goodsId 商品ID
coverImgUrl 商品图片链接
name 商品名称
price 价格左区间,单位“元”
price2 价格右区间,单位“元”
url 商品小程序路径
priceType 1:一口价,此时读price字段; 2:价格区间,此时price字段为左边界,price2字段为右边界; 3:折扣价,此时price字段为原价,price2字段为现价;
thirdPartyTag 1、2:表示是为 API 添加商品,否则是直播控制台添加的商品
thirdPartyAppid 当商品为第三方小程序的商品则为对应第三方小程序的appid,自身小程序商品则为''

调用示例

示例说明: HTTPS请求示例

请求数据示例

https://api.weixin.qq.com/wxaapi/broadcast/goods/getapproved?access_token=[access_token]& status=2 

返回数据示例

{
    "errcode":0,
    "total":68,
    "goods":
        [
            {
                "goodsId":9,
                "coverImgUrl":"xxxx",
                "name":"xxxxx"
                "price":12300,
                "url":"xxxxxxx",
                "priceType":1,
                "price2":0,
                "thirdPartyTag":0
            }
        ]
} 

错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试
40001 invalid credential access_token isinvalid or not latest 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
200002 参数错误
posted on 2025-01-15 09:15  AtlasLapetos  阅读(20)  评论(0)    收藏  举报