# 获取所有类目

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getallcategoryfromleague

可通过该接口获取全部的类目信息、类目的资质信息、商品资质信息。 启用新多级类目树提示:旧的类目树固定为三级类目结构,新的类目树为多级类目结构,过渡期间,新旧类目树兼容使用,请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。 此接口新增cats_v2字段支持新类目树,详见返回参数。

提醒:数据较多,接口耗时较高

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/channels/ec/category/league/all?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
catsobjarraycats
cats_v2objarraycats_v2

# Res.cats(Array) Object Payload

cats

参数名类型说明
cat_and_quaobjarraycat_and_qua

# Res.cats_v2(Array) Object Payload

cats_v2

参数名类型说明
cat_and_quaobjarraycat_and_qua

# Res.cats(Array).cat_and_quaObject Payload

cat_and_qua

参数名类型说明
catobjectcat
quaobjectqua
product_quaobject商品资质信息,将废弃,使用product_qua_list代替
brand_quaobject品牌资质信息
product_qua_listobjarray商品资质列表,替代product_qua
is_confidence_require_bad_must_payboolean放心买必须打开坏损包赔

# Res.cats(Array).cat_and_qua.cat Object Payload

cat

参数名类型说明
cat_idnumber类目ID
namestring类目名称
f_cat_idnumber父类目ID
levelnumber类目等级

# Res.cats(Array).cat_and_qua.qua Object Payload

qua

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean该类目申请的时候是否一定要提交资质

# Res.cats(Array).cat_and_qua.product_qua Object Payload

商品资质信息,将废弃,使用product_qua_list代替

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

# Res.cats(Array).cat_and_qua.brand_qua Object Payload

品牌资质信息

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean申请此类目时是否必须提交资质证明
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明

# Res.cats(Array).cat_and_qua.product_qua_listObject Payload

商品资质列表,替代product_qua

参数名类型说明
qua_idnumber资质ID
need_to_applyboolean该类目是否需要申请才能用
tipsstring资质信息
mandatoryboolean申请此类目时是否必须提交资质证明
namestring-

# Res.cats_v2(Array).cat_and_quaObject Payload

cat_and_qua

参数名类型说明
catobjectcat
quaobjectqua
product_quaobject新类目树--商品资质信息,将废弃,使用product_qua_list代替
brand_quaobject新类目树--品牌资质信息
product_qua_listobjarray新类目树--商品资质列表,替代product_qua
is_confidence_require_bad_must_payboolean放心买必须打开坏损包赔

# Res.cats_v2(Array).cat_and_qua.cat Object Payload

cat

参数名类型说明
cat_idnumber新类目树--类目ID
namestring新类目树--类目名称
f_cat_idnumber新类目树--父类目ID
levelnumber新类目树--类目等级
leafboolean新类目树--是否为叶子类目(品类)

# Res.cats_v2(Array).cat_and_qua.qua Object Payload

qua

参数名类型说明
qua_idnumber新类目树--资质ID
need_to_applyboolean新类目树--该类目是否需要申请才能用
tipsstring新类目树--资质信息
mandatoryboolean新类目树--该类目申请的时候是否一定要提交资质

# Res.cats_v2(Array).cat_and_qua.product_qua Object Payload

新类目树--商品资质信息,将废弃,使用product_qua_list代替

参数名类型说明
qua_idnumber新类目树--资质ID
need_to_applyboolean新类目树--该类目是否需要申请才能用
tipsstring新类目树--资质信息
mandatoryboolean新类目树--申请此类目时是否必须提交资质证明

# Res.cats_v2(Array).cat_and_qua.brand_qua Object Payload

新类目树--品牌资质信息

参数名类型说明
qua_idnumber新类目树--资质ID
need_to_applyboolean新类目树--申请此类目时是否必须提交资质证明
tipsstring新类目树--资质信息
mandatoryboolean新类目树--申请此类目时是否必须提交资质证明

# Res.cats_v2(Array).cat_and_qua.product_qua_listObject Payload

新类目树--商品资质列表,替代product_qua

参数名类型说明
qua_idnumber新类目树--资质ID
need_to_applyboolean新类目树--该类目是否需要申请才能用
tipsstring新类目树--资质的描述信息
mandatoryboolean新类目树--申请此类目时是否必须提交资质证明
namestring新类目树--资质名称

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "cats": [
        {
            "cat_and_qua": [
                {
                    "cat": {
                        "cat_id": "1003",
                        "name": "假牙清洁",
                        "f_cat_id": "1002",
                        "level": 3
                    },
                    "qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "product_qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "brand_qua": {
                        "qua_id": "xxx",
                        "need_to_apply": true,
                        "tips": "",
                        "mandatory": true
                    },
                    "product_qua_list": [
                        {
                            "qua_id": "1111487",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品,可提供作品授权证明/大师资质证明",
                            "mandatory": true,
                            "name": "作品授权证明/大师资质证明"
                        },
                        {
                            "qua_id": "1111488",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品,可提供鉴定证书",
                            "mandatory": false,
                            "name": "鉴定证书"
                        },
                        {
                            "qua_id": "1111489",
                            "need_to_apply": true,
                            "tips": "若涉及名人或大师作品,可提供收藏证书",
                            "mandatory": false,
                            "name": "收藏证书"
                        }
                    ]
                },
                {
                    "cat": {
                        "cat_id": "1002",
                        "name": "口腔护理",
                        "f_cat_id": "1001",
                        "level": 2
                    }
                },
                {
                    "cat": {
                        "cat_id": "1001",
                        "name": "个人护理",
                        "f_cat_id": "0",
                        "level": 1
                    }
                }
            ]
        }
    ],
    "cats_v2": [
        {
            "cat_and_qua": [
                {
                    "cat": {
                        "cat_id": "545709",
                        "name": "公路电子收费/ETC/OBU",
                        "f_cat_id": "10000131",
                        "level": 3,
                        "leaf": true
                    },
                    "qua": {
                        "qua_id": "1111608",
                        "need_to_apply": true,
                        "tips": "1、主体要求\n(1)入驻主体类型仅限于企业。\n(2)开店主体公司注册资本不低于100万,注册时间不少于1年。\n\n2、行业资质\n(1)交通运输部指定全国各省份的ETC发行机构或合作机构。需提交交通部或交通厅关于ETC发行服务机构的信息公开单位证明截图,或同等效力的证明材料;参考示例:《证明材料示例》https://docs.qq.com/doc/DVXBuUHpPSFdmYmJW\n(2)需提交关于合法合规经营产品的承诺函。承诺函模板:https://docs.qq.com/doc/p/68313cd4ca24c6f0577d5ed3578c906ae9d67c91",
                        "mandatory": true
                    },
                    "brand_qua": {
                        "qua_id": "1111609",
                        "need_to_apply": true,
                        "tips": "1、属于品牌商标权利人/一级授权经销商。\n2、品牌须在京东有开设自营旗舰店/自营官方旗舰店或在天猫有开设官方旗舰店店铺;\n3、品牌须在在京东开设的自营旗舰店/自营官方旗舰店或在天猫开设的官方旗舰店店铺主营类目需和申请视频号橱窗定向准入的类目一致,请提供相应截图。\n4、品牌商标注册证需包含所申请范围",
                        "mandatory": true
                    },
                    "product_qua_list": [

                    ]
                },
                {
                    "cat": {
                        "cat_id": "10000131",
                        "name": "车载电器",
                        "f_cat_id": "10000126",
                        "level": 2,
                        "leaf": false
                    },
                    "product_qua_list": [

                    ]
                },
                {
                    "cat": {
                        "cat_id": "10000126",
                        "name": "汽车",
                        "f_cat_id": "0",
                        "level": 1,
                        "leaf": false
                    },
                    "product_qua_list": [

                    ]
                }
            ]
        }
    ]
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
9401020参数有误

# 7. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。