Appearance
登录与测试流程
本页描述新账号当前真实的测试路径。先在控制台完成实例登录和 Playground 验证，再把 API 凭证与真实 wId 接入后端。
本文所称“微信执行实例”，是微信账号由账号本人或经合法授权的操作人员扫码登录后形成的在线执行环境，不是公众号、小程序或企业微信官方接口。后文简称“微信实例”。
最快成功标准
API Playground 向 filehelper 发送文本后，手机微信的文件传输助手实际收到消息。
流程总览
| 步骤 | 在哪里操作 | 产出 |
|---|---|---|
| 1 | 控制台兑换免费试用 | 默认应用、应用凭证 |
| 2 | 微信执行实例 | 在线实例、真实 wId |
| 3 | API Playground | 文件传输助手收到测试消息 |
| 4 | 业务后端 | 使用 API 凭证正式调用 API |
1. 兑换免费试用
- 注册并登录 Eyun 控制台。
- 兑换 7 天免费试用。
- 兑换完成后，系统自动生成「默认应用」和该应用的凭证。
此时不需要手动创建应用。API 凭证将在后端正式调用时使用。
2. 登录微信实例
- 进入「微信执行实例」。
- 点击添加实例。
- 选择一种登录网络。
- 使用手机微信扫码并确认。
- 确认实例状态为在线。
登录网络是必选项，且只能三选一：
| 登录网络 | 适用场景 | 要求 |
|---|---|---|
| 平台代理 | 平台已有与账号常用地区匹配的线路 | 选择一条平台线路 |
| 自定义代理 | 已有稳定的自有 Socks5 代理 | 填写代理地址和凭证 |
| 本地代理（Aid） | 使用门店、办公室、家宽或同城设备网络 | 先启动 Aid，登录期间保持运行 |
需要本地网络时，参考 Aid 本地代理。普通用户优先使用 Windows；长期固定出口再使用同城 Linux 设备。
3. 在 API Playground 发送消息
- 打开 API Playground。
- 选择「发送文本」接口。
- 在实例选择器中选择上一步已登录的微信实例。
- 接收方填写
filehelper。 - 输入测试文本并发送。
- 打开手机微信，检查文件传输助手是否收到消息。
Auth 归属
Playground 会自动使用当前登录账号的 Auth（API 凭证），不需要再次复制或填写。
| 结果 | 判断 | 排查入口 |
|---|---|---|
| 文件传输助手收到消息 | 首次测试成功 | 继续后端调用 |
| Playground 成功但未收到 | 检查实例、在线状态和 filehelper | API 使用与安全 |
| Playground 返回失败 | 根据 message 和错误码排查 | 发送错误码 |
4. 在后端正式调用
- 进入「应用凭证」。
- 打开微信实例所属应用，查看
eyk_开头的 API 凭证。 - 复制实例的真实
wId。 - 在后端请求中使用 API 凭证和
wId。
bash
curl -X POST https://你的接口域名/sendText \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyk_your_auth" \
-d '{
"wId": "your-instance-id",
"wcId": "filehelper",
"content": "Hello from Eyun"
}'凭证安全
API 凭证只应保存在服务端。不要写入网页、客户端安装包、公开仓库或前端日志。
什么时候配置 Webhook
发送测试消息不需要 Webhook。只有业务需要接收微信消息或事件时，才继续配置：
后端自行完成登录
控制台测试通过后，如果业务后端还需要自动完成微信登录，再按接口顺序接入：
这条路径与控制台登录最终都得到同一类 Auth 和 wId。如果开发者账号只使用短信验证码登录且尚未设置密码，请先在控制台「账户安全」设置密码，再调用 Step 1。