# 设置展示在店铺主页的商品分类
# 接口说明
通过该接口可设置展示在店铺主页的商品分类
# 注意事项
- 商品分类由2部分数据组成,分别是分类树和分类商品。这个接口是对分类树进行操作,不影响分类节点跟商品的关联关系。
- 分类树目前支持2级树结构。每一级分类支持设置最多20个分类。分类名字不能超过20个字符。
- 每一个分类节点可以设置是否隐藏。如果一级分类隐藏,那么所有子分类都必须设置为隐藏。
- 平台会对分类名字进行审核。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/store/classification/tree/set?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
req.tree.level_1.id | number | 是 | 一级分类id。在这颗树里必须全局唯一,不能重复。 |
req.tree.level_1.name | string | 是 | 一级分类名字 |
req.tree.level_1.is_displayed | number | 是 | 是否在用户端展示该分类。1为是,0为否 |
req.tree.level_1.level_2.id | string | 是 | 二级分类名字 |
req.tree.level_1.level_2.name | string | 是 | 二级分类名字 |
req.tree.level_1.level_2.is_displayed | number | 是 | 是否在用户端展示该分类.1为是,0为否 |
req.version | number | 是 | 版本号。通过获取商品分类树或者本接口得到 |
req.classification_id_deleted | string | 是 | 表示有哪一些分类ID清空关联得商品,如果不清空,那么分类ID和商品得关联关系会一直存在。如果是一级分类,就填"1"。如果是二级分类,就填"1.2"。 |
# 请求示例
{
"req": {
"version": 121,
"classification_id_deleted": [
"1.2"
],
"tree": {
"level_1": [
{
"id": 4,
"name": "测试7",
"level_2": [
{
"id": 5,
"name": "1",
"is_displayed": 1
}
],
"is_displayed": 1
},
{
"id": 6,
"name": "测试8",
"level_2": [
{
"id": 7,
"name": "1",
"is_displayed": 1
},
{
"id": 8,
"name": "2",
"is_displayed": 1
}
],
"is_displayed": 1
}
]
}
}
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
resp.version | number | 版本号。设置分类树的接口会用到 |
resp.audit_results.level_id | number | 该分类ID的审核结果 |
resp.audit_results.result_code | number | 审核结果枚举。1:不通过;2:通过 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"resp": {
"version": 123,
"audit_results": [
{
"level_id": 4,
"result_code": 2
},
{
"level_id": 5,
"result_code": 2
},
{
"level_id": 6,
"result_code": 2
},
{
"level_id": 7,
"result_code": 2
},
{
"level_id": 8,
"result_code": 2
}
]
}
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
1721111580 | 参数错误 |
1721111581 | 版本号不对 |
1721111583 | 太多分类节点 |
1721111590 | 分类ID重复 |
1721111588 | 父子分类的隐藏配置有冲突 |
1721111589 | 存在审核失败的分类名 |