# 添加类目

调试工具

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

# 接口说明

# 接口英文名

addCategory

# 功能描述

调用本接口可以给小程序添加类目,添加的类目需要在所有可设置的类目列表中。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

# 调用方式

# HTTPS 调用


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

# 第三方调用

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

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

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

# 请求参数

属性 类型 必填说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token
categories array<object> 类目信息列表
属性 类型 必填 说明
first number 一级类目 ID
second number 二级类目 ID
certicates array<object> 资质信息列表。如果需要资质的类目,则该字段必填
属性 类型 必填 说明
key string 资质名称
value string 资质图片,要填media_id(可通过新增临时素材接口获取)
expire_time number
is_permanent number

# 返回参数

属性 类型 说明
errcode number 错误码
errmsg string 错误信息

# 其他说明

# 类目审核结果事件推送

# 字段说明

参数 类型 字段描述
first string 一级类目id
second string 二级类目id
ret number 审核结果 2.驳回,3通过
reason string 审核失败的驳回原因

推送内容解密后的示例:

<xml>
	<ToUserName><![CDATA[gh_fxxxxxxxa4b2]]></ToUserName>
	<FromUserName><![CDATA[odxxxxM-xxxxxxxx-trm4a7apsU8]]></FromUserName>
	<CreateTime>1488800000</CreateTime>
	<MsgType><![CDATA[event]]></MsgType>
	<Event><![CDATA[wxa_category_audit]]></Event>
	<ret>2</ret>
	<first>一级类目id</nickname>
	<second>二级类目id</reason>
      <reason>驳回原因</reason>
</xml>

# 调用示例

示例说明: HTTPS请求

# 请求数据示例


{
  "categories": [
    {
      "first": 8,
      "second": 39,
      "certicates": [
        {
          "key": "《因私出入境中介机构经营许可证》",
          "value": "media_id"
        }
      ]
    }
  ]
} 

# 返回数据示例


{
  "errcode": 0,
  "errmsg":"ok",
} 

# 错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试
40001 invalid credential  access_token isinvalid or not latest 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
40007 invalid media_id 不合法的媒体文件 id
53300 超出每月次数限制 超出每月次数限制
53301 超出可配置类目总数限制 超出可配置类目总数限制
53302 当前账号主体类型不允许设置此种类目 当前账号主体类型不允许设置此种类目
53303 提交的参数不合法 提交的参数不合法
53304 与已有类目重复 与已有类目重复
53311 需要提交资料信息 需要提交资料信息