# 获取分类关联的商品ID列表
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:GetClassificationProductList
通过该接口可获取分类关联的商品 ID 列表。商品分类由 2 部分数据组成,分别是分类树和分类商品。这个接口是获取分类关联的商品 ID 列表。一个分类最多关联 500 个商品。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/store/classification/tree/product/get?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| req | object | 是 | - |
# Body.req Object Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| level_1_id | number | 是 | 1 | 一级分类 ID,通过 获取在店铺主页展示的商品分类 接口获取 |
| level_2_id | number | 是 | 0 | 二级分类 ID,通过 获取在店铺主页展示的商品分类 接口获取 |
| page_context | string | 是 | 翻页上下文,由上次请求返回 | |
| page_size | number | 是 | 10 | 每页数量 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| product_ids | numarray | [1, 2] | 分类关联的商品 ID 列表 |
| page_context | string | 翻页上下文,用于请求下一页。为空表示已到最后一页 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"req": {
"level_1_id": 1,
"level_2_id": 0,
"page_size": 10,
"page_context": ""
}
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"product_ids": [1, 2],
"page_context": ""
}
# 6. 错误码
此接口没有特殊错误码,可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
# 7. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。