# 获取商品活动补贴信息
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:league_get_product_activity_info
获取联盟商品的活动信息(目前仅有平台补贴)
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/product/getactivity?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| product_id | number | 是 | 1234567890 | 商品ID,必填 |
| shop_appid | string | 是 | wx1234567890abcdef | 所属小店appid,必填 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误描述 |
| has_activity | boolean | 是否有活动 | |
| product_activity_list | objarray | 商品活动信息列表 |
# Res.product_activity_list(Array) Object Payload
商品活动信息列表
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| product_id | number | - | |
| sku_id | number | - | |
| activity_price | number | 999 | 活动价(单位:分) |
| platform_subsidy | number | 100 | 平台补贴金额(单位:分) |
| platform_subsidy_cnt | number | 1000 | 平台补贴件数 |
| activity_sub_type | number | 3 | 目前仅支持“3 品牌日 4通用货补”,其他活动类型不返回 |
| activity_end_time | number | - | |
| activity_name | string | 超品日 | 活动名称 |
| stock_mode | number | 1 | 0 活动库存 1 商品自营库存 |
| stock_number | number | 5000 | 库存 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"product_id": 1234567890,
"shop_appid": "wx1234567890abcdef"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"has_activity": false,
"product_activity_list": [
{
"product_id": 0,
"sku_id": 0,
"activity_price": 999,
"platform_subsidy": 100,
"platform_subsidy_cnt": 1000,
"activity_sub_type": 1,
"activity_end_time": 0,
"activity_name": "超品日",
"stock_mode": 1,
"stock_number": 5000
}
]
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | system error | 获取商品活动信息失败或服务内部异常,系统繁忙,请稍后重试 |
| 10024000 | 参数错误 | 请检查 product_id 是否为空、shop_appid 是否为空 |
| 10024009 | 不合法的商品ID | product_id 对应的商品不存在,或获取商品 SKU 信息失败,请确认商品是否存在且已上架 |
| 10024012 | 获取店铺信息失败 | shop_appid 对应的账号不存在或查询失败,请确认 shop_appid 是否正确 |
# 7. 适用范围
本接口支持「联盟带货机构」账号类型调用。其他账号类型如无特殊说明,均不可调用。
2026 年 03 月 27 日
优化库存描述
2026 年 03 月 09 日
上线