# 添加类目
接口应在服务器端调用,详细说明参见服务端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> | 是 | 类目信息列表 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
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 | 需要提交资料信息 | 需要提交资料信息 |