# Set Mini Program name

Debugging tools

Interface should be called on the server side, seeHattori API

# Interface Dxplaination

# Interface name

setNickName

# Functional description

  • Call this interface can set the name of the Mini Program, when the name does not hit the keyword, then directly set the successWhen the name hits the keyword, proof materials need to be submitted and it needs to be reviewed. Audit results are received for messages and events URL ConductEvent Push
  • If you encounter problems during use, you canOpen Platform Service Provider ZonePosting exchanges

# Note

  • The number of names that can be changed before the mini program is released is 2, and when the name change is still required to continue after the upper limit of the number of names, it is necessary to re-launch the WeChat certification name change.

# Calling mode

# HTTPS call


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

# Third Party Invocation

  • The calling method and parameters are the same as HTTPS, only the calling token is different

  • The permission set id to which this interface belongs is: 30, 61

  • After the service provider has been authorized with one of the permission sets, it can do so by usingauthorizer_access_TokenCalling on behalf of the merchant

# Request parameters

attribute type Required Introductions
access_Token string yes Interface invokes the certificate, which is URL Parameters, non Body Parameters. useauthorizer_access_Token
nick_name string yes Nicknames that contain the "Mini Program" keyword are not supported
id_card string yes ID Photo Mediaid, Personal ID required
license string yes Organization code certificate or business license Mediaid, Organization Number required
naming_other_stuff_1 string no Other proof materials medians
naming_other_stuff_2 string no Other proof materials medians
naming_other_stuff_3 string no Other proof materials medians
naming_other_stuff_4 string no Other proof materials medians
naming_other_stuff_5 string no Other proof materials medians

# Return parameters

attribute type Introductions
errcode number Return code
errmsg string Error message
wording string Dxplaination of materials
audit_id number Audit Sheet Id, by using theQuery Name Change Review Status

# Other Notes

# Name Audit Results Event Push

Small name changeThe results of the audit are received to the messages and events URL Push relevant notifications.

# Name Audit Results Event Push Instructions

parameter type Field Description
nickname string Nicknames that need to be changed
ret number Audit results 2: Failure, 3: Success
reason string Reasons for Rejection of Audit Failure

Example after the push content is decrypted:

<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</ret>
	<nickname>nickname</nickname>
	<reason>Reasons for dismissal</reason>
</xml>

# Call Example

Example Dxplaination: HTTPS requests

# Sample Request Data


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

# Return Data Example


{
  "errcode": 0,
  "errmsg": "ok",
  "wording": "",
  "audit_id": 12345
}
Note: If the interface does not return audit_Id, indicating that the name has been directly set successfully, without auditing 

# Error code

Error code Error code Solutions
91001 not fast register Not multiplexing. Official Account message template Fast-created Mini Programs and Mini Programs not registered through the FastRegister Business Mini Programs interface
91002 has published You can't change your name after the Mini Programs are released
91003 invalid change stat Name change is illegal.
91004 invalid nickname Nicknames are illegal.
91005 nickname 15 God's protection.
91007 nickname used Nickname is already occupied
91008 Nicknamehit 7 Days of Infringement Protection Period
91009 nickname need proof Need to submit material
91010 Other errors
91011 Can not find the nickname change audit sheet information Can not find the nickname change audit sheet information
91012 Other errors
91013 Too many names.
91014 diff master plus + rule The same type of joint body is inconsistent
91015 diff master Different types of original names are inconsistent
91016 name more owner Name occupier 2
91017 other diff master plus + rule Different types of joint names are inconsistent