Appearance
从注册到首条消息
新账号不需要先创建应用。兑换试用后,控制台会自动生成「默认应用」和 API 凭证。先在控制台跑通真实消息,再把同一套参数接入后端。
最短路径
| 阶段 | 在哪里操作 | 完成标志 |
|---|---|---|
| 1. 兑换试用 | 控制台概览 | 出现 7 天试用和「默认应用」 |
| 2. 登录微信 | 微信执行实例 | 实例状态显示在线,并获得 wId |
| 3. 测试发送 | API Playground | filehelper 收到测试文本 |
| 4. 接入后端 | 你的服务端 | 使用 API 凭证和真实 wId 调用成功 |
为什么先用 Playground
它能先证明账号、网络、微信实例和 Auth 都可用。若这里成功而业务代码失败,排查范围就只剩请求地址、请求头和参数。
1. 兑换试用
登录 Eyun 控制台,在概览页选择「立即激活试用」,按页面要求填写试用信息。
激活成功后,系统会自动创建:
- 一份 7 天试用权益。
- 一个名为「默认应用」的应用凭证。
- 一个以
eyk_开头的 API 凭证。
2. 登录微信
进入「微信执行实例」,选择新增实例并扫码登录。登录网络必须在以下三种方式中选择一种:
| 网络方式 | 适合场景 |
|---|---|
| 平台代理 | 已有适合账号常用地区的平台线路 |
| 自定义代理 | 团队已有稳定、可控的代理出口 |
| Aid 本地代理 | 使用办公室、门店、家宽或同城设备作为出口 |
不知道怎么选时,先阅读 Aid 本地代理。
3. 在 Playground 发送消息
微信实例显示在线后,打开 API Playground:
- 选择「默认应用」。
- 选择刚登录的微信实例。
- 选择发送文本接口。
- 将目标
wcId填为filehelper。 - 发送一条测试文本。
手机微信的「文件传输助手」收到消息,即表示首次链路已跑通。
4. 接入后端
在「应用凭证」打开「默认应用」,复制 API 凭证。生产代码只在服务端保存该凭证,不要放入浏览器、App 包或公开仓库。
bash
curl -X POST https://你的接口域名/sendText \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyk_your_auth" \
-d '{
"wId": "你的登录实例ID",
"wcId": "filehelper",
"content": "Hello from Eyun"
}'下一步:查看 API 参考或配置 Webhook。
