# 查询橱窗上团长商品列表

# 接口说明

可通过该接口查询橱窗上团长商品列表

# 接口调用请求说明

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