小程序信息设置

注意

该章节接口需要使用 1.3 环节获取到的新创建小程序 appid 及 authorization_code 换取 authorizer_refresh_token 进而得到 authorizer_access_token。

1 获取帐号基本信息

请求方式：

GET

URL：https://api.weixin.qq.com/cgi-bin/account/getaccountbasicinfo?access_token=TOKEN

返回数据：

{
  "errcode": 0,
  "errmsg": "ok",
  "appid": "wxdc685123d955453",
  "account_type": 2,
  "principal_type": 1,
  "principal_name": "深圳市腾讯计算机系统有限公司",
  "realname_status": 1,
  "wx_verify_info": {
    "qualification_verify": 1,
    "naming_verify": 1,
    "annual_review": 1,
    "annual_review_begin_time": 1550490981,
    "annual_review_end_time": 1558266981
  },
  "signature_info": {
    "signature": "功能介绍",
    "modify_used_count": 1,
    "modify_quota": 5
  },
  "head_image_info": {
    "head_image_url": "http://mmbiz.qpic.cn/mmbiz/a5icZrUmbV8p5jb6RZ8aYfjfS2AVle8URwBt8QIu6XbGewB9wiaWYWkPwq4R7pfdsFibuLkic16UcxDSNYtB8HnC1Q/0",
    "modify_used_count": 3,
    "modify_quota": 5
  }
}

参数说明：

返回码说明：

errcode 取值	说明
非 0	异常

2 小程序名称设置及改名

请求方式:

POST(请使用 https 协议)

https://api.weixin.qq.com/wxa/setnickname?access_token=TOKEN

POST 数据示例:

{
  "nick_name": "XXX 公司",
  "id_card": "3LaLzqiTrQcD20DlX_o-OV1",
  "license": "3LaLzqiTrQcD20DlX_o-OV22231",
  "naming_other_stuff_1": "3LaLzqiTrQcD20DlX_o-OV1-nlYMu7sdVAL7SV2PrxVyjZFZZmB3O6LPGaYXlZWq",
  "naming_other_stuff_2": ""
}

请求参数:

参数	说明	备注
nick_name	昵称	必填
id_card	身份证照片–临时素材 mediaid 个人号	必填
license	组织机构代码证或营业执照–临时素材 mediaid 组织号	必填
naming_other_stuff_1	其他证明材料—临时素材 mediaid	选填
naming_other_stuff_2	其他证明材料—临时素材 mediaid	选填

注意

注:临时素材 mediaid 通过调用”临时素材管理接口”获取.

新增临时素材: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738726

获取临时素材: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738727

第三方代小程序调用上述接口: https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resourceres_list&verify=1&id=open1453779503&token=&lang=zh_CN

返回 json 示例(门店小程序类目分一级和二级类目):

{
  "errcode": 0,
  "errmsg": "ok",
  "wording": "",
  "audit_id": 12345
}

返回参数说明:

参数	说明
wording	材料说明
audit_id	审核单 id

注意

注：若接口未返回 audit_id，说明名称已直接设置成功，无需审核；若返回 audit_id 则名称正在审核中。

错误码说明:

返回码	说明
91001	不是公众号快速创建的小程序
91002	小程序发布后不可改名
91003	改名状态不合法
91004	昵称不合法
91005	昵称命中主体保护
91006	昵称命中微信号
91007	昵称已被占用
91008	昵称命中 7 天侵权保护期
91009	需要提交材料
91010	其他错误

审核事件推送

数据示例：

<xml>
  <ToUserName><![CDATA[gh_fxxxxxxxa4b2]]></ToUserName>
  <FromUserName><![CDATA[odxxxxM-xxxxxxxx-trm4a7apsU8]]></FromUserName>
  <CreateTime>1488800000</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[wxa_nickname_audit]]></Event>
  <ret>2失败，3成功</ret>
  <nickname>昵称</nickname>
  <reason>驳回原因</reason>
</xml>

3 小程序改名审核状态查询

请求方式：

POST（请使用 https 协议）

https://api.weixin.qq.com/wxa/api_wxa_querynickname?access_token=TOKEN

POST 数据示例：

{
  "audit_id": "12345"
}

请求参数：

参数	说明	备注
audit_id	审核单 id	必填

返回 json 示例：

{
  "errcode": 0,
  "errmsg": "ok",
  "nickname": "xxx",
  "audit_stat": 2,
  "fail_reason": "xxx",
  "create_time": 1519724071,
  "audit_time": 1519724950
}

返回参数说明：

参数	说明
nickname	审核昵称
audit_stat	审核状态，1：审核中，2：审核失败，3：审核成功
fail_reason	失败原因
create_time	审核提交时间
audit_time	审核完成时间

错误码说明：

返回码	说明
91011	查不到昵称修改审核单信息
91012	其它错误

4 微信认证名称检测

请求方式：

POST(请使用 https 协议)

URL：https://api.weixin.qq.com/cgi-bin/wxverify/checkwxverifynickname?access_token=TOKEN

POST 数据：

{
  "nick_name": "杨幂的测试用例"
}

参数说明：

参数	必填/选填	类型	说明
nick_name	必填	string	名称（昵称）

返回数据：

{
  "errcode": 0,
  "errmsg": "ok",
  "hit_condition": true,
  "wording": "你申请的名称可能涉及特定主体姓名或名称，请提供可确认主体材料与名称对应的材料，或提供《商标注册证》等其他材料，以证明你有权合理且善意使用该名称，否则可能审核不通过"
}

参数说明：

参数名	类型	描述
hit_condition	bool	是否命中关键字策略。若命中，可以选填关键字材料
wording	string	命中关键字的说明描述（给用户看的）

返回码说明：

5 修改头像

请求方式：

POST(请使用 https 协议)

URL：https://api.weixin.qq.com/cgi-bin/account/modifyheadimage?access_token=TOKEN

POST 数据：

{
  "head_img_media_id": "mI-4E_sFh_2X3g-qmTIWD83RT78ytI1_6VfgFp_A3-Y2U5T_nLl3nm1xYTafFJ8p",
  "x1": 0,
  "y1": 0,
  "x2": 0.7596899224806202,
  "y2": 0.49
}

参数说明：

参数名	必填/选填	类型	说明
head_img_media_id	必填	media_id	头像素材 media_id
x1	必填	float	裁剪框左上角 x 坐标（取值范围：[0, 1]）
y1	必填	float	裁剪框左上角 y 坐标（取值范围：[0, 1]）
x2	必填	float	裁剪框右下角 x 坐标（取值范围：[0, 1]）
y2	必填	float	裁剪框右下角 y 坐标（取值范围：[0, 1]）

返回数据：

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

图片格式只支持：BMP、JPEG、JPG、GIF、PNG，大小不超过 2M

注：实际头像始终为正方形

示例示意图：

头像示意图

返回码说明：

errcode 取值	说明
40097	参数错误
41006	media_id 不能为空
40007	非法的 media_id
46001	media_id 不存在
40009	图片尺寸太大
53202	本月头像修改次数已用完

6 修改功能介绍

请求方式：

POST(请使用 https 协议)

URL：https://api.weixin.qq.com/cgi-bin/account/modifysignature?access_token=TOKEN

POST 数据：

{
  "signature": "提供好玩的服务。"
}

参数说明：

参数名	必填/选填	类型	说明
signature	必填	string	功能介绍（简介）

返回数据：

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

返回码说明：

errcode 取值	说明
40097	参数错误
53200	本月功能介绍修改次数已用完
53201	功能介绍内容命中黑名单关键字

7 换绑小程序管理员接口

流程

• 步骤一：从第三方平台页面发起，并跳转至微信公众平台指定换绑页面。

• 步骤二：小程序原管理员扫码，并填写原管理员身份证信息确认。

• 步骤三：填写新管理员信息(姓名、身份证、手机号)，使用新管理员的微信确认。

• 步骤四：点击提交后跳转至第三方平台页面，第三方平台回调对应 api 完成换绑流程。

流程及接口说明

7.1 从第三方平台跳转至微信公众平台授权注册页面

从第三方平台跳转到微信公众平台授权页，需携带的参数如下：

跳转到微信公众平台授权页面链接举例:

https://mp.weixin.qq.com/wxopen/componentrebindadmin?appid=wx28f759479ea1e090&component_appid=wx666666666666123&redirect_uri=https%3a%2f%2f www.qq.com%2fauth%2fcallback%3ffrom%3dmp

7.2 小程序新旧管理员填写信息，扫码确认提交后跳转回第三方平台

点击页面提交按钮。 跳转回第三方平台，会在上述 redirect_uri 后拼接 taskid=\* 跳转回第三方平台举例：

https://www.qq.com/auth/callback?taskid=b25519093b1e97239eff9d2bfc07e08e

7.3 跳转至第三方平台，第三方平台调用快速注册 API 完成管理员换绑。

请求方式：

请求方式: POST(请使用 https 协议) https://api.weixin.qq.com/cgi- bin/account/componentrebindadmin?access_token=TOKEN

请求示例:

{
  "taskid": "b25519093b1e97239eff9d2bfc07e08e"
}

参数说明:

参数	说明
taskid	换绑管理员任务序列号(公众平台最终点击提交回跳到第三方平台时携带)

返回说明:

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

参数说明 参数 说明 errcode 错误码 errmsg 错误信息

错误码说明

错误码	错误码说明
85060	无效的 taskid
85027	身份证绑定管理员名额达到上限
85061	手机号绑定管理员名额达到上限
85026	微信号绑定管理员名额达到上限
85063	身份证黑名单
85062	手机号黑名单

8 类目相关接口

注：该章节接口需要使用 1.3 环节获取到的新创建小程序 appid 及 authorization_code 换取 authorizer_refresh_token 进而得到 authorizer_access_token。

8.1 获取账号可以设置的所有类目

请求方式：

GET 数据 URL：https://api.weixin.qq.com/cgi-bin/wxopen/getallcategories?access_token=TOKEN

返回参数（JSON 格式）：

{
  "errcode": 0,
  "errmsg": "ok",
  "category_list": {
    "categories": [
      {
        "children": [874],
        "father": 0,
        "id": 868,
        "level": 1,
        "name": "时政信息",
        "qualify": {
          "exter_list": [
            {
              "inner_list": [
                {
                  "name": "有资质证件：《互联网新闻信息服务许可证》",
                  "url": ""
                }
              ]
            },
            {
              "inner_list": [
                {
                  "name": "无资质：ICP 备案和《组织机构代码证》",
                  "url": ""
                }
              ]
            }
          ]
        },
        "sensitive_type": 1
      }
    ]
  }
}

参数说明：

参数名	说明
id	类目 ID
Name	类目名称
Level	类目层级
Father	类目父级 ID
Children	子级类目 ID
Sensitive_type	是否为敏感类目（1 为敏感类目，需要提供相应资质审核；0 为非敏感类目，无需审核）
Qualify.exter_list.inner_list.name	Sensitive_type 为 1 的类目需要提供的资质文件名称
Qualify.exter_list.inner_list.url	资质文件示例

8.2 添加类目

请求方式：

POST(请使用 https 协议) URL：https://api.weixin.qq.com/cgi-bin/wxopen/addcategory?access_token=TOKEN

请求参数：

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

参数说明：

参数名	必填/选填	类型	说明
first	必填	Unsigned int	一级类目 ID
Second	必填	Unsigned int	二级类目 ID
Key	必填	String	资质名称
Value	必填	media_id	资质图片

返回参数（JSON 格式）：

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

8.3 删除类目

请求方式：

POST(请使用 https 协议)

URL：https://api.weixin.qq.com/cgi-bin/wxopen/deletecategory?access_token=TOKEN

参数说明：

参数名	必填/选填	类型	说明
first	必填	Unsigned int	一级类目 ID
Second	必填	Unsigned int	二级类目 ID

返回（JSON 格式）：

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

8.4 获取账号已经设置的所有类目

请求方式：

GET

URL：https://api.weixin.qq.com/cgi-bin/wxopen/getcategory?access_token=TOKEN

参数说明：

返回（JSON 格式）：

{
  "errcode": 0,
  "errmsg": "ok",
  "categories": [
    {
      "first": 8,
      "first_name": "教育",
      "second": 39,
      "second_name": "出国移民",
      "audit_status": 1,
      "audit_reason": ""
    }
  ],
  "limit": 5,
  "quota": 4,
  "category_limit": 20
}

参数说明：

参数名	必填/选填	类型	说明
first	必填	Unsigned int	一级类目 ID
First_name	必填	string	一级类目名称
Second	必填	Unsigned int	二级类目 ID
Second_name	必填	string	二级类目名称
Audit_status	必填	Unsigned int	审核状态（1 审核中 2 审核不通过 3 审核通过）
audit_reason	必填	String	审核不通过原因
Limit	必填	Unsigned int	一个更改周期内可以设置类目的次数
Quota	必填	Unsigned int	本更改周期内还可以设置类目的次数
Category_limit	必填	Unsigned int	最多可以设置的类目数量

8.5 修改类目

请求方式：

POST(请使用 https 协议) URL：https://api.weixin.qq.com/cgi-bin/wxopen/modifycategory?access_token=TOKEN

POST 数据：

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

参数说明：

参数名	必填/选填	类型	说明
first	必填	Unsigned int	一级类目 ID
Second	必填	Unsigned int	二级类目 ID
Key	必填	String	资质名称
Value	必填	String	资质图片

返回（JSON 格式）：

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

返回码说明：

errcode 取值	说明
53300	超出每月次数限制
53301	超出可配置类目总数限制
53302	当前账号主体类型不允许设置此种类目
53303	提交的参数不合法
53304	与已有类目重复
53305	包含未通过 IPC 校验的类目
53306	修改类目只允许修改类目资质，不允许修改类目 ID
53307	只有审核失败的类目允许修改
53308	审核中的类目不允许删除