# 设置名称
调用本接口可以设置小程序名称,当名称没有命中关键词,则直接设置成功;当名称命中关键词,需提交证明材料,并需要审核。审核结果会向消息与事件接收 URL 进行事件推送。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
说明:小程序发布前可改名的次数为2,当改名次数上限后仍需继续改名时需要重新发起微信认证改名。
# 请求地址
POST https://api.weixin.qq.com/wxa/setnickname?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 第三方平台接口调用令牌authorizer_access_token |
nick_name | string | 是 | 昵称,不支持包含“小程序”关键字的昵称 |
id_card | media_id | 个人号必填 | 身份证照片 mediaid |
license | media_id | 组织号必填 | 组织机构代码证或营业执照 mediaid |
naming_other_stuff_1 | media_id | 否 | 其他证明材料 mediaid |
naming_other_stuff_2 | media_id | 否 | 其他证明材料 mediaid |
naming_other_stuff_3 | media_id | 否 | 其他证明材料 mediaid |
naming_other_stuff_4 | media_id | 否 | 其他证明材料 mediaid |
naming_other_stuff_5 | media_id | 否 | 其他证明材料 mediaid |
# media_id
临时素材 mediaid 通过调用“临时素材管理接口”获取.请注意调用如下两个接口时需要使用第三方平台接口调用令牌authorizer_access_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": "",
}
# 返回参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 错误信息 |
wording | string | 材料说明 |
audit_id | number | 审核单 id,通过用于查询改名审核状态 |
返回结果示例:
{
"errcode": 0,
"errmsg": "ok",
"wording": "",
"audit_id": 12345
}
注意: 若接口未返回 audit_id,说明名称已直接设置成功,无需审核;
# 返回码说明
返回码 | 说明 |
---|---|
91001 | 不是公众号快速创建的小程序 |
91002 | 小程序发布后不可改名 |
91003 | 改名状态不合法,小程序发布前可改名的次数为2次,请确认改名次数是否已达上限 |
91004 | 昵称不合法 |
91005 | 昵称 15 天主体保护 |
91006 | 昵称命中微信号 |
91007 | 昵称已被占用 |
91008 | 昵称命中 7 天侵权保护期 |
91009 | 需要提交材料 |
91010 | 其他错误 |
91011 | 查不到昵称修改审核单信息 |
91012 | 其他错误 |
91013 | 占用名字过多 |
91014 | +号规则 同一类型关联名主体不一致 |
91015 | 指的是已经有同名的公众号,但是那个公众号的主体和当前小程序主体不一致 |
91016 | 名称占用者 ≥2 |
91017 | +号规则 不同类型关联名主体不一致 |
其他错误码 | 请查看全局错误码 |