# 注册试用小程序

调试工具

接口应在服务器端调用,详细说明参见服务端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】。

创建试用小程序成功/失败的通知数据示例

<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个字符(不包含的试用小程序这六个汉字的占用)