获取可用的子类目详情 | 微信开放文档

# 获取可用的子类目详情

# 接口说明

该接口可根据父类目ID获取可用的子类目详情

# 注意事项

多次调用该接口分别拿到一，二，三，...，N级类目，如果某个 N-1 级类目下的 N 级类目是空，则说明这个 N-1 级类目下的所有 N 级类目都需要申请定向准入资质

启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。 此接口新增 cat_list_v2 字段支持新类目树，详见返回参数。 根据请求参数 f_cat_id，设置不同的返回字段，下方示例分别针对这三种情况给到对比说明 1.f_cat_id 为旧类目树中的非叶子类目，仅设置 cat_list 字段。 2.f_cat_id 为新类目树中的非叶子类目，仅设置 cat_list_v2 字段。 3.f_cat_id 为0，同时设置 cat_list 和 cat_list_v2 字段。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/category/availablesoncategories/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
f_cat_id	string(uint64)	是	父类目ID，可先填0获取根部类目

# 请求参数示例

{
    "f_cat_id": 0
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
cat_list[].cat_id	string(uint64)	类目ID
cat_list[].f_cat_id	string(uint64)	类目父ID
cat_list[].name	string	类目名称
cat_list_v2[].cat_id	string(uint64)	类目ID
cat_list_v2[].f_cat_id	string(uint64)	类目父ID
cat_list_v2[].name	string	类目名称
cat_list_v2[].leaf	boolean	是否为叶子结点（品类）

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "cat_list": [
        {
            "cat_id": 1,
            "f_cat_id": 0,
            "name": "服饰"
        },
        {
            "cat_id": 2,
            "f_cat_id": 0,
            "name": "鞋帽"
        }
    ],
     "cat_list_v2": [
        {
            "cat_id": 1,
            "f_cat_id": 0,
            "name": "服饰",
            "leaf": false
        },
        {
            "cat_id": 2,
            "f_cat_id": 0,
            "name": "鞋帽",
            "leaf": false
        },
        {
            "cat_id": 3,
            "f_cat_id": 0,
            "name": "生鲜水产",
            "leaf": false
        }
    ]
}

# 错误码

错误码	错误描述
公共错误码	-
9401020	参数有误，请开发人员检查传递参数是否正确