开放平台
取消
中文
中文
EN
取消
  • 第三方平台

    • # 创建试用小程序

    该接口用于快速创建试用小程序。使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

    # 业务逻辑描述

    关于试用小程序的业务介绍可查看https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/product/Register_Mini_Programs/beta_mp_introduction.html

    此外，为了便于服务商更好地理解该接口的使用，请详细阅读如下描述：

    1、 接口返回authorize_url（授权确认URL），需要服务商将url发送给用户（平台不下发模板消息给用户），用户点击后进入h5的页面

    2、该url有效期是24小时。以及，如果用户在页面操作后创建失败了，需要服务商重新获取新的url发送给用户

    3、 用户确认之后则会会生成未认证的小程序appid，并且完成第三方授权

    4、 服务商可以通过授权事件接收 URL接收到生成的appid

    5、 该微信用户默认为该小程序的管理员，并且默认有体验的权限

    # 请求地址

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

    # 请求参数说明

    参数 类型 必填 说明
    access_token String 是 第三方平台令牌component_access_token
    name String 是 小程序名称，昵称半自动设定，强制后缀“的体验小程序”。且该参数会进行关键字检查，如果命中品牌关键字则会报错。
    如遇到品牌大客户要用试用小程序，建议用户先换个名字，认证后再修改成品牌名。
    只支持4-30个字符
    openid String 是 微信用户的openid（不是微信号），试用小程序创建成功后会默认将该用户设置为小程序管理员。
    获取openid的方法请查看公众号获取openid
    h5获取openid、小程序获取openid、网站应用获取openid

    POST 数据示例:

    {
  "name": "小麦烤鸡",
  "openid": "oK8Yg5YaUM-axuE_vVZmV_oIZxxx"
}

    # 返回参数说明

    参数 类型 说明
    errcode number 返回码
    errmsg string 错误信息
    unique_id string 该请求的唯一标识符，用于关联微信用户和后面产生的appid
    authorize_url string 用户授权确认url，需将该url发送给用户，用户进入授权页面完成授权方可创建小程序

    返回结果示例：

    {
    "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"
}

    # 返回码说明

    返回码 说明
    86011 名称命中了关键字；像小程序、微信、腾讯等以及知名品牌关键字。请更换名字后重试。
    86012 openid不合法
    61071 该微信用户创建试用小程序已经5个，达到上限
    61072 该微信号错误或者为不活跃低信用户，通常为微信小号，请更换为正常的微信号后重试。
    86017 试用小程序名称长度错误。只支持4-30个字符（不包含的试用小程序这六个汉字的占用）
    其他错误码 请查看全局错误码

    # 用户授权页面交互示例图

    • 该授权页面24h内有效，需提醒用户及时进行授权确认。

    # 消息推送规则

    由于该接口涉及用户的授权确认操作，为异步操作的流程，因此用户的操作状态平台会将相关信息推送到【授权事件接收 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 同一个票据不支持重复创建小程序

    # 用户收到的模板消息的规则

    由于该试用小程序有效期仅为14天，则平台会通过微信公众平台给用户发模板消息。

    • 注销通知：注销当时会发送通知