# 获取联盟商品推广列表

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/league/item/list/get?access_token=ACCESS_TOKEN

# 请求参数示例

{
    "type": 1, 
    "page_size": 1,
    "page_index": 1
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "items": {
        "product_id": 123456
    },
    "total_num": 10
}

# 请求参数说明

参数 类型 是否必填 说明
type number 商品推广类别
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后该值无效)

# 注意

  • 接口限制了 page_size × page_index ≤ 5000。命中限制时建议改用传last_buffer顺序翻页的请求方式

# 回包参数说明

参数 类型 说明
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 是否还有剩余商品

# 枚举-type

枚举值 描述
1 普通推广商品
2 定向推广商品
3 专属推广商品

# 错误码

错误码 错误信息
公共错误码 点击查看
10023000 参数错误
10023001 不合法的finder_id
10023100 type类型错误
10023103 不存在该推广商品
10023007 请先开通优选联盟