# 获取联盟商品推广列表
# 接口说明
可通过该接口获取联盟商品推广列表
# 注意事项
- 接口限制了 page_size × page_index ≤ 5000；
- 命中限制时建议改用传last_buffer顺序翻页的请求方式。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/league/item/list/get?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| type | number | 是 | 商品推广类别，枚举值详情请参考type |
| page_size | number | 是 | 单页商品数（不超过100） |
| page_index | number | 否 | 页面下标，下标从1开始，默认为1 |
| product_id | string(uint64) | 否 | 商品id，获取特殊推广商品时有效 |
| finder_id | string | 否 | 视频号id，获取特殊推广商品时有效 |
| last_buffer | string | 否 | 由上次请求返回，顺序翻页时需要传入, 会从上次返回的结果往后翻一页（填了该值后page_index不生效） |
| need_total_num | bool | 否 | 是否需要返回满足筛选条件的商品总数（填last_buffer后该值无效） |
# 请求参数示例
{
"type": 1,
"page_size": 1,
"page_index": 1
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| items[].product_id | string(uint64) | 商品id |
| items[].info_id | string(uint64) | 特殊推广商品计划id |
| last_buffer | string | 本次翻页的上下文，用于顺序翻页请求 |
| total_num | number | 商品总数 |
| has_more | bool | 是否还有剩余商品 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"items": {
"product_id": 123456
},
"total_num": 10
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10023000 | 参数错误，请开发者检查参数是否正确 |
| 10023001 | 不合法的finder_id |
| 10023100 | type类型错误 |
| 10023103 | 不存在该推广商品 |
| 10023007 | 请先开通优选联盟 |
# 枚举值
# type
商品推广类别
| 枚举值 | 描述 |
|---|---|
| 1 | 普通推广商品 |
| 2 | 定向推广商品 |
| 3 | 专属推广商品 |