查询橱窗上团长商品列表

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

# 接口说明

可通过该接口查询橱窗上团长商品列表 注意：本次修改（2025年2月修改）支持查询达人所有橱窗商品，但针对删除操作时会进行权限校验。仅支持将属于机构或者机构添加的商品移出橱窗。 情况如下：

机构	商品类型	添加操作者	是否可将商品移出橱窗	说明
A	普通商品	A	是	与商品类型无关，操作者是A，则A可以移出橱窗
A	机构A商品	B	是	与操作者无关，商品属于A，则A可以移出橱窗
A	机构B商品	达人	否	无
B	普通商品	A	否	无
B	机构A商品	B	是	与商品类型无关，操作者是B，则B可以移出橱窗
B	机构B商品	达人	是	与操作者无关，商品属于B，则B可以移出橱窗

# 接口调用请求说明

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
is_get_all	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
product_window_id	number(uint64)	商品在橱窗的ID，用来移除橱窗操作
is_operation_allowed	bool	是否有操作权限，true-可操作；false-不可操作