status 字段新增「商品下架终止推广」「计划过期终止推广」「商品被封禁下架终止推广」等3个选项# 获取联盟推广计划详情
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：getitem
可通过该接口获取联盟推广计划详情
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/league/item/get?access_token=ACCESS_TOKEN
# 云调用
调用方法：channels.ec.league.item.get
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：141
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| type | number | 是 | 获取商品推广类别 | 枚举值 |
| product_id | number | 是 | 商品id | - |
| promotion_plan_id | number | 否 | 推广计划id | - |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| item | object | 推广计划信息 |
# Res.item Object Payload
推广计划信息
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| product_id | number | 商品id | - |
| type | number | 商品推广类别 | 枚举值 |
| status | number | 商品推广状态 | 枚举值 |
| ratio | number | 推广佣金[0, 90]% | - |
| exclusive_info | object | 推广信息 | - |
| ext_info | object | 扩展信息 | - |
# Res.item.exclusive_info Object Payload
推广信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| promotion_plan_id | number | 推广计划id |
| begin_time | number | - |
| end_time | number | - |
| is_forerver | boolean | - |
| talent_num | number | 推广带货者数量 |
# Res.item.ext_info Object Payload
扩展信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| is_banned | boolean | 是否被官方封禁 |
# 4. 枚举信息
# Body.type Enum
获取商品推广类别
| 枚举值 | 描述 |
|---|---|
| 100 | 全部带货者计划 |
| 300 | 指定带货者计划 |
# Res.item.type Enum
商品推广类别
| 枚举值 | 描述 |
|---|---|
| 1 | 普通推广商品 |
| 2 | 定向推广商品 |
| 3 | 专属推广商品 |
# Res.item.status Enum
商品推广状态
| 枚举值 | 描述 |
|---|---|
| 1 | 已上架推广 |
| 2 | 已下架推广 |
| 4 | 已删除 |
| 5 | 未达到准入标准 |
| 7 | 商品下架终止推广 |
| 8 | 计划过期终止推广 |
| 9 | 商品被封禁下架终止推广 |
| 10 | 待生效 |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
请求示例
{
"type": 0,
"product_id": 0,
"promotion_plan_id": 0
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"item": {
"product_id": "1000001",
"type": 3,
"status": 1,
"ratio": 10,
"exclusive_info": {
"info_id": "123",
"finder_ids": [
"sphAAAA",
"sphBBBB",
"sphCCCC"
],
"finder_num": 3,
"finder_info_list": [
{
"finder_id": "sphAAAA",
"begin_time": 1669867200,
"end_time": 1672459200
},
{
"finder_id": "sphBBBB",
"begin_time": 1669867200,
"end_time": 1672459200
},
{
"finder_id": "sphCCCC",
"begin_time": 1669867200,
"end_time": 1672459200
}
]
},
"ext_info": {
"is_sale_forbidden": false
}
}
}
# 7. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 10023000 | 参数错误 |
| 10023001 | 不合法的finder_id |
| 10023007 | 请先开通优选联盟 |
| 10023100 | type类型错误 |
| 10023103 | 不存在该商品 |
# 8. 适用范围
本接口支持「微信小店（需申请）」账号类型调用。其他账号类型如无特殊说明，均不可调用。
接口变更日志（2条）2026 年 07 月 15 日
2026 年 06 月 17 日
promotion_plan_id 字段新增， info_id 字段已删除