# 快速注册个人小程序

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:fastRegisterPersonalMp

关于快速注册小程序的详细介绍以及使用步骤等请查看快速注册个人小程序介绍,本文为快速注册小程序的接口文档。

自2023年12月25日起,通过本接口新注册的账号默认为未认证状态,需完成认证后方可获得“被搜索、分享”能力,未认证不影响账号发布上架。如如第三方开发者需为其发起认证,可通过 代认证小程序接口提交申请。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 component_access_token

# 请求体 Request Payload

参数名类型必填说明
idnamestring个人用户名字
wxuserstring个人用户微信号
component_phonestring第三方联系电话

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明枚举
errcodenumber返回码-
errmsgstring错误信息-
taskidstring任务id,后面query查询需要用到-
authorize_urlstring给用户扫码认证的验证url-
statusnumber任务的状态枚举值

# 4. 枚举信息

# Res.status Enum

任务的状态

枚举值描述
0生成任务
1任务超时
2任务已经被用户拒绝
3用户同意创建
4已经发起人脸流程
5人脸认证失败
6人脸认证ok
7人脸认证后,已经提交手机号码下发验证码
8手机验证失败
9手机验证成功
10手机号验证成功后,提交了创建
11创建失败
12创建成功
13验证成功
14验证失败
1001主体创建小程序数量达到上限
1002主体违规命中黑名单
1003管理员绑定账号数量达到上限
1004管理员违规命中黑名单
1005管理员手机绑定账号数量达到上限
1006管理员手机号违规命中黑名单
1007管理员身份证创建账号数量达到上限
1008管理员身份证违规命中黑名单

# 5. 注意事项

  • 通过该接口注册的小程序不可绑定微信支付商户号。
  • 该接口每分钟调用频率为:5/mini
  • 该接口每天的调用次数为:100/天
  • 开发者应该合理控制接口的调用频率和每天的调用次数

# 事件推送

注册成功失败的结果会向授权事件接收 URL 推送相关通知。

# 数据示例

<xml>
    <AppId><![CDATA[第三方平台appid]]></AppId>
    <CreateTime>1535442403</CreateTime>
    <InfoType><![CDATA[notify_third_fasteregister]]></InfoType>
    <appid>创建小程序appid</appid>
    <status>0</status>
    <auth_code>xxxxx第三方授权码</auth_code>
    <msg>OK</msg>
    <info>
    <wxuser><![CDATA[用户微信号]]></wxuser>
    <idname><![CDATA[用户姓名]]></wxidnnn>
    <component_phone><![CDATA[第三方联系电话]]></component_phone>
    </info>
</xml>

# status状态码说明

status 返回 含义
1001 主体创建小程序数量达到上限
1002 主体违规命中黑名单
1003 管理员绑定账号数量达到上限
1004 管理员违规命中黑名单
1005 管理员手机绑定账号数量达到上限
1006 管理员手机号违规命中黑名单
1007 管理员身份证创建账号数量达到上限
1008 管理员身份证违规命中黑名单

# 6. 代码示例

# 5.1 快速注册个人小程序

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=create&component_access_token=ACCESS_TOKEN
{
"idname": "tencent", // 个人用户名字
"wxuser": "wxidnnn", // 个人用户微信id
"component_phone": "1234567" //第三方联系电话
 }

返回示例

{
"errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK" // 错误信息
"taskid": "xxxxx". // 任务id,后面query查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 5.2 查询创建任务状态

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=query&component_access_token=ACCESS_TOKEN
{
"taskid": "xxxxx" // 创建任务成功时,返回的taskid
 }

返回示例

{
 "errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK", // 错误信息
"taskid": "xxxxx". // 任务id,后面 query 查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
45009reach max api daily quota limit超出接口每日调用限制
45011api minute-quota reach limit  mustslower  retry next minuteAPI 调用太频繁,请稍候再试
86030提交的json数据缺少需要的参数;缺少参数
86031内部错误;第三方号无效或未全网发布
86032无效微信号;微信id无效
86033第三方号的缺少所需权限集;第三方号的权限集缺失
86036姓名与微信号不一致
91030this wxuser has reached their daily limit of api calls.每个微信号每天只能调用该接口5次,已达上限了。建议服务商在产品界面给予用户更清晰的指引,接口中要求填微信号的参数只支持填入微信号,不支持填手机号或者微信名称。

# 8. 适用范围

本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明,均不可调用。