# 查询橱窗上团长商品列表
# 接口说明
可通过该接口查询橱窗上团长商品列表
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/window/getall?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
appid | string | 否 | 团长appid |
finder_id | string | 否 | 视频号finder_id,未填openfinderid时必填,后续废弃 |
openfinderid | string | 是 | 视频号openfinderid |
offset | number(uint32) | 是 | 起始位置(从0开始) |
page_size | number(uint32) | 否 | 每页数量(默认100, 最大500) |
need_total_num | bool | 否 | 是否需要返回橱窗上团长商品总数,默认为false |
# 请求参数示例
{
"appid": "app1234",
"finder_id": "sph1234",
"offset": 0,
"page_size": 100,
"need_total_num": true
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
list | object ItemKey | 商品概要列表,结构体详情请参考ItemKey |
next_offset | number | 下一页的位置 |
have_more | bool | 后面是否还有商品 |
total_num | number | 商品总数 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"list": [
{
"appid": "test1",
"product_id": 12345
},
{
"appid": "test2",
"product_id": 12346
}
],
"next_offset": 100,
"have_more": true,
"total_num": 369
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10024000 | 参数错误,请开发者检查请求参数是否正确 |
10024001 | 不合法的finder_id |
10024003 | 不合法的appid |
10024009 | 不合法的product_id |
10024010 | 橱窗操作失败 |
10024011 | 未获得橱窗授权 |
# 结构体
# ItemKey
商品概要
参数 | 类型 | 描述 |
---|---|---|
appid | string | 团长appid |
product_id | number(uint64) | 团长商品ID |