# 获取可设置的所有类目

调试工具

接口应在服务器端调用,详细说明参见服务端API

# 接口说明

# 接口英文名

getAllCategories

# 功能描述

本接口可以获取该小程序允许设置的所有类目且仅支持获取一级类目和二级类目,注意不同主体所允许设置的类目不同。使用过程中如遇到问题,可在开放平台服务商专区发帖交流

# 调用方式

# HTTPS 调用


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

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:30、61

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 返回参数

属性 类型说明
errcode number 错误码
errmsg string 错误信息
categories_list object 类目信息列表
属性 类型 说明
categories array<object> 类目信息
属性 类型 说明
id number 类目 ID
name bufffer 类目名称
level number 类目层级
father number 类目父级 ID
children array<number> 子级类目 ID
sensitive_type number 是否为敏感类目(1 为敏感类目,需要提供相应资质审核;0 为非敏感类目,无需审核)
qualify object sensitive_type 为 1 的类目需要提供的资质证明,通过qualify.exter_list.inner_list.name可查看资质名称。
属性 类型 说明
exter_list array<object> 资质证明列表
属性 类型 说明
inner_list array<object> inner_list
属性 类型 说明
name string 资质文件名称
url string 资质文件示例
remark string 备注

# 其他说明

1、id == 0 的类目是根节点,它的 children 是一级类目

# 调用示例

示例说明: HTTPS请求

# 请求数据示例


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

# 返回数据示例


{
  "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": ""
                }
              ]
            }
          ]
        }
      }
    ]
  }
} 

# 错误码

错误码 错误码取值 解决方案
40001 invalid credential  access_token isinvalid or not latest 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口