绑定体验者

最后一次编辑于 2026-03-16

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

接口英文名:bindTester

本接口用于将微信用户绑定为小程序体验成员。

第三方平台在帮助旗下授权的小程序提交代码审核之前,可先让小程序用户体验,体验之前需要将个人微信号添加到该小程序的体验者名单中。

1. 调用方式

HTTPS 调用

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

云调用

  • 本接口不支持云调用。

第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:18

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

2. 请求参数

查询参数 Query String Parameters

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

请求体 Request Payload

参数名类型必填说明
wechatidstring是微信号

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
userstrstring人员对应的唯一字符串

4. 注意事项

如果运营者同时也是该小程序的管理员,则无需绑定,管理员默认有体验权限。

5. 代码示例

请求示例

{
  "wechatid": "testid"
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "userstr": "xxxxxxxxx"
}

6. 错误码

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

错误码错误描述解决方案
0okok
85001user not exist or user cannot be searched微信号不存在或微信号设置为不可搜索
85002number of tester reach bind limit小程序绑定的体验者数量达到上限
85003user already bind too many weapps微信号绑定的小程序体验者达到上限
85004user already bind微信号已经绑定

7. 适用范围

本接口支持「第三方平台」账号类型代调用,权限集请参考「调用方式」部分。其他账号类型如无特殊说明,均不可调用。