# 获取所有类目
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getallcategory
可通过该接口获取全部的类目信息、类目的资质信息、商品资质信息。
启用新多级类目树提示:旧的类目树固定为三级类目结构,新的类目树为多级类目结构,过渡期间,新旧类目树兼容使用,请开发者尽快切换到新多级类目树。其中差异请参阅下方“新旧类目树差异”。 此接口新增cats_v2字段支持新类目树,详见返回参数。
# 新旧类目树差异
- 旧类目树为固定的三级类目结构,如“酒类(7339) -- 洋酒(7344) -- 国产白兰地(545301)”。 新类目树为多级类目结构,不再固定三级,如“酒类(10000201) -- 洋酒(10000204) -- 白兰地/干邑(10000454) -- 国产白兰地(545301)”。
- 对于叶子类目(也称品类),在新旧类目树中,都是一一映射的,也就是说,在旧类目树中的叶子类目,必定在新类目树中也会存在一个一摸一样的叶子类目,名称和ID都是相同的;对于非叶子类目,在新旧类目树中,不存在任何映射关系。
- 目前小店B端、C端都已更换为新类目树,API调用仍同时兼容新旧类目树,请开发者尽快迁移到新类目树开发。
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/shop/ec/category/all?access_token=ACCESS_TOKEN
# 云调用
调用方法:channels.ec.category.all
出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:85、129
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
无
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
cats | objarray | 旧类目信息 |
cats_v2 | objarray | 新类目信息 |
# Res.cats(Array) Object Payload
旧类目信息
参数名 | 类型 | 说明 |
---|---|---|
cat_and_qua | objarray | 类目数据 |
# Res.cats_v2(Array) Object Payload
新类目信息
参数名 | 类型 | 说明 |
---|---|---|
cat_and_qua | objarray | 类目数据 |
# Res.cats(Array).cat_and_quaObject Payload
Object Payload
类目数据
参数名 | 类型 | 说明 |
---|---|---|
cat | object | 类目详情 |
qua | object | 资质详情 |
product_qua | object | 商品资质信息,将废弃,使用product_qua_list代替 |
brand_qua | object | 品牌资质信息 |
product_qua_list | objarray | 商品资质列表,替代product_qua |
is_confidence_require_bad_must_pay | boolean | 放心买必须打开坏损包赔 |
# Res.cats(Array).cat_and_qua.cat Object Payload
Object Payload
类目详情
参数名 | 类型 | 说明 |
---|---|---|
cat_id | number | 类目ID |
name | string | 类目名称 |
f_cat_id | number | 父类目ID |
level | number | 类目等级 |
# Res.cats(Array).cat_and_qua.qua Object Payload
Object Payload
资质详情
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质信息 |
mandatory | boolean | 该类目申请的时候是否一定要提交资质 |
cert_group_list | objarray | 证照信息 |
# Res.cats(Array).cat_and_qua.qua.cert_group_listObject Payload
Object Payload
证照信息
参数名 | 类型 | 说明 |
---|---|---|
license_group_id | number | 证照组id,证照组内的证照选一个填写提交即可 |
is_necessary | number | 是否必填 |
busi_license_desc | string | 证照组说明 |
license_list | objarray | 证照列表 |
# Res.cats(Array).cat_and_qua.qua.cert_group_list.license_listObject Payload
Object Payload
证照列表
参数名 | 类型 | 说明 |
---|---|---|
id | number | 证照id |
name | string | 证照名称 |
is_necessary | number | 是否必填 |
license_field_list | objarray | 填写字段 |
# Res.cats(Array).cat_and_qua.qua.cert_group_list.license_list.license_field_listObject Payload
Object Payload
填写字段
参数名 | 类型 | 说明 |
---|---|---|
field_key | string | 填写字段类型,详见field_key枚举 |
field_name | string | 填写字段名称 |
info | string | 字段正则要求 |
is_necessary | number | 是否必填 |
# Res.cats(Array).cat_and_qua.product_qua Object Payload
Object Payload
商品资质信息,将废弃,使用product_qua_list代替
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
# Res.cats(Array).cat_and_qua.brand_qua Object Payload
Object Payload
品牌资质信息
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 申请此类目时是否必须提交资质证明 |
tips | string | 资质信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
# Res.cats(Array).cat_and_qua.product_qua_listObject Payload
Object Payload
商品资质列表,替代product_qua
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质的描述信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
name | string | 资质名称 |
# Res.cats_v2(Array).cat_and_quaObject Payload
Object Payload
类目数据
参数名 | 类型 | 说明 |
---|---|---|
cat | object | 类目详情 |
qua | object | 资质详情 |
product_qua | object | 商品资质信息,将废弃,使用product_qua_list代替 |
brand_qua | object | 品牌资质信息 |
product_qua_list | objarray | 商品资质列表,替代product_qua |
is_confidence_require_bad_must_pay | boolean | 放心买必须打开坏损包赔 |
# Res.cats_v2(Array).cat_and_qua.cat Object Payload
Object Payload
类目详情
参数名 | 类型 | 说明 |
---|---|---|
cat_id | number | 类目ID |
name | string | 类目名称 |
f_cat_id | number | 父类目ID |
level | number | 类目等级 |
leaf | boolean | 是否为叶子类目(品类) |
# Res.cats_v2(Array).cat_and_qua.qua Object Payload
Object Payload
资质详情
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质信息 |
mandatory | boolean | 该类目申请的时候是否一定要提交资质 |
# Res.cats_v2(Array).cat_and_qua.product_qua Object Payload
Object Payload
商品资质信息,将废弃,使用product_qua_list代替
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
# Res.cats_v2(Array).cat_and_qua.brand_qua Object Payload
Object Payload
品牌资质信息
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 申请此类目时是否必须提交资质证明 |
tips | string | 资质信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
# Res.cats_v2(Array).cat_and_qua.product_qua_listObject Payload
Object Payload
商品资质列表,替代product_qua
参数名 | 类型 | 说明 |
---|---|---|
qua_id | number | 资质ID |
need_to_apply | boolean | 该类目是否需要申请才能用 |
tips | string | 资质的描述信息 |
mandatory | boolean | 申请此类目时是否必须提交资质证明 |
name | string | 资质名称 |
# 4. 注意事项
field_key枚举
[
{
"name": "许可证编号",
"key": "audit_license_no"
},
{
"name": "备案编号",
"key": "audit_license_registration_no"
},
{
"name": "有效期",
"key": "audit_license_validty_period"
}
]
# 5. 代码示例
请求示例
GET https://api.weixin.qq.com/shop/ec/category/all?access_token=ACCESS_TOKEN
返回示例
{
"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. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。