获取不同主体类型的类目

本接口用于获取不同主体对应的可设置的类目信息,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

说明

  • 适用于的主体类型有:个人、企业、政府、媒体、其他组织
  • 接口功能描述:本接口可以获取不同主体类型可设置的所有类目,且仅支持获取一级类目和二级类目。
  • 适用范围:普通小程序、快速注册的小程序、试用小程序(不返回小游戏类目)
  • 且不区分法人快注可设置类目,该接口返回的是不同主体类型可设置的类目,而法人扫脸的方式只支持企业和个体工商户

请求地址

POST https://api.weixin.qq.com/cgi-bin/wxopen/getcategoriesbytype?access_token=ACCESS_TOKEN

请求参数说明

参数 类型 必填 说明
access_token string 第三方平台接口调用令牌
verify_type number 如果不填,默认传0;个人主体是0;企业主体是1;政府是2;媒体是3;其他组织是4

返回参数说明

参数 类型 说明
errcode number 返回码
errmsg string 错误信息
categories_list.categories object array 类目信息列表

类目信息说明

参数 类型 说明
id number 类目 ID
name string 类目名称
level number 类目层级
father number 类目父级 ID
children number array 子级类目 ID
sensitive_type number 是否为敏感类目(1 为敏感类目,需要提供相应资质审核;0 为非敏感类目,无需审核)
qualify.exter_list object array sensitive_type 为 1 的类目需要提供的资质证明

注意: id == 0 的类目是根节点,它的 children 是一级类目

敏感类目需提供的资质信息说明

qualify.exter_list 的数组每一项中都有个 inner_list 对象列表; inner_list 中每一项的参数说明如下:

参数 类型 说明
name string 资质文件名称
url string 资质文件示例

返回结果示例:

{
  "errcode": 0,
  "errmsg": "ok",
  "categories_list": {
    "categories": [
      {
        "id": 0,
        "children": [1, 402],
        "qualify": {
          "exter_list": [],
          "remark": ""
        }
      },
      {
        "id": 1,
        "name": "快递业与邮政",
        "level": 1,
        "father": 0,
        "children": [2, 5, 556, 558, 1033],
        "sensitive_type": 0,
        "qualify": {
          "exter_list": [],
          "remark": ""
        }
      },
      {
        "id": 920,
        "name": "律师",
        "level": 2,
        "father": 402,
        "children": [],
        "sensitive_type": 1,
        "qualify": {
          "exter_list": [
            {
              "inner_list": [
                {
                  "name": "《律师执业资格证》",
                  "url": ""
                }
              ]
            }
          ]
        }
      }
    ]
  }
}