# 设置名称

调用本接口可以设置小程序名称,当名称没有命中关键词,则直接设置成功;当名称命中关键词,需提交证明材料,并需要审核。审核结果会向消息与事件接收 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 +号规则 不同类型关联名主体不一致
其他错误码 请查看全局错误码