# 注册试用小程序
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
registerBetaMiniprogram
# 功能描述
该接口用于快速创建试用小程序。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
# 注意事项
为了便于服务商更好地理解该接口的使用,务必先阅读试用小程序的业务介绍
在试用小程序的业务介绍文档中会详细描述接口使用逻辑,有对应的用户授权页面交互示例图、用户收到的模板消息的规则等等。
请注意:试用小程序的quota和普通个人小程序的quota共用,即同一微信号只可绑定5个小程序。详情查看小程序注册上限和绑定上限说明。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/component/fastregisterbetaweapp?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用component_access_token |
name | string | 是 | 小程序名称,昵称半自动设定,强制后缀“的体验小程序”。且该参数会进行关键字检查,如果命中品牌关键字则会报错。 如遇到品牌大客户要用试用小程序,建议用户先换个名字,认证后再修改成品牌名。 只支持4-30个字符 |
openid | string | 是 | 微信用户的openid(不是微信号),试用小程序创建成功后会默认将该用户设置为小程序管理员。 获取openid的方法请查看公众号获取openid h5获取openid、小程序获取openid、网站应用获取openid |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
unique_id | string | 该请求的唯一标识符,用于关联微信用户和后面产生的appid |
authorize_url | string | 用户授权确认url,需将该url发送给用户,小程序管理员在微信打开并进入授权页面完成授权方可创建小程序 |
# 其他说明
# 消息推送规则
由于该接口涉及用户的授权确认操作,为异步操作的流程,因此用户的操作状态平台会将相关信息推送到【授权事件接收 URL】。
- 创建试用小程序成功/失败的通知,相关数据示例请查看下文。
- 授权成功通知的数据示例请查看:https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/authorize_event.html
创建试用小程序成功/失败的通知数据示例
<xml>
<AppId><![CDATA[第三方平台appid]]></AppId>
<CreateTime>1535442403</CreateTime>
<InfoType><![CDATA[notify_third_fastregisterbetaapp]]></InfoType>
<appid>创建小程序appid<appid>
<status>0</status>
<msg>OK</msg>
<info>
<unique_id><![CDATA[unique_id]]></unique_id>
<name><![CDATA[小程序名称]]></name>
</info>
</xml>
status | 含义 |
---|---|
0 | ok,小程序创建成功 |
3 | overdue unconfirmed,用户超时未确认 |
-1 | system error,小程序创建失败,系统错误 |
750001 | 申请者微信与确认授权者微信不是同一个用户 |
750004 | create_token不合法,即token里包含的身份和实际使用时的身份不一样 |
750011 | 获取权限集列表失败,请检查该第三方的权限集是否已全网发布生效后,再重试。 |
750002 | 小程序授权给第三方失败,请检查该第三方的权限集是否已全网发布生效后,再重试。 |
-2000001 | 平台系统内部错误,请到社区反馈 |
-2000002 | 平台系统内部错误,请到社区反馈 |
-2000003 | 同一个票据不支持重复创建小程序 |
# 调用示例
示例说明: HTTPS调用示例
# 请求数据示例
{
"name": "小麦烤鸡",
"openid": "oK8Yg5YaUM-axuE_vVZmV_oIZxxx"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"unique_id": "BV8ToNpYUMSeoRgsDi7-_cyo2hMtcbJN4fDPEdOKAGSResiIK8VefChe6UkNhxOi",
"authorize_url": "https://mp.weixin.qq.com/wxawap/fastregistertpbeta?action=show&create_token=BV8ToNpYUMSeoRgsDi7-_cyo2hMtcbxxxxxxxxxxxIK8VefChe6UkNhxOi#wechat_redirect"
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
86011 | 名称命中了关键字;像小程序、微信、腾讯等以及知名品牌关键字。请更换名字后重试。 | 请更换名字后重试。 |
86012 | openid不合法 | |
61071 | 该微信用户创建试用小程序已经5个,达到上限 | 该微信用户创建试用小程序已经5个,达到上限 |
61072 | 该微信号错误或者为不活跃低信用户,通常为微信小号,请更换为正常的微信号后重试。 | 该微信号错误或者为不活跃低信用户,通常为微信小号,请更换为正常的微信号后重试。 |
86017 | 试用小程序名称长度错误。只支持4-30个字符(不包含的试用小程序这六个汉字的占用) | 试用小程序名称长度错误。只支持4-30个字符(不包含的试用小程序这六个汉字的占用) |