快速开始

先打开 Eyun 控制台，按下面四步完成第一次收发。这四步在控制台操作；跑通后再用 curl 调用接口。

1. 领取 API 凭证

激活试用或购买后，在应用凭证页点击「领取 Auth」，复制并保存完整凭证。勾选「我已安全保存这把 Auth」，点击「已保存，扫码登录」。

API 凭证就是控制台里的 Auth。完整凭证只展示一次，后续调用接口需要使用这个值。

完成标志：你已保存完整凭证，并进入扫码弹窗。

已有应用，页面只显示掩码怎么办？

使用之前保存的完整 API 凭证，掩码不能用于调用。确实遗失时，才到应用安全设置重置；旧凭证立即失效，自己的服务端也要更新。首次接入不需要重置已有凭证。

2. 扫码登录

在扫码弹窗选择与手机微信常用登录地区匹配的网络，由账号本人扫码并在手机确认。出现验证提示时，按弹窗操作。也可从微信实例页开始登录。

完成标志：控制台显示当前账号「在线」。 已有在线账号可直接进入下一步。

三种网络方式怎么选？

网络方式	什么时候选
平台代理	平台已有适合账号常用地区的线路
自定义代理	团队已有稳定的 Socks5 代理
Aid 本地代理	使用办公室、门店、家宽或同城设备所在的网络

详细说明见登录账号与网络设置。

3. 给自己发消息

扫码成功后点击「测试消息收发」，确认页面显示的是刚登录的账号，点击「发送这条消息」。打开手机微信，在文件传输助手中看到测试文本后，点击「我已在微信中看到这条消息」。

完成标志：手机上确实收到测试文本。 发送目标默认是文件传输助手（filehelper），不用查自己的微信 ID。已有在线账号可直接打开收发测试。

返回成功但手机未收到时，先核对所选账号和在线状态，不要反复发送；接口报错时看发送错误码。

4. 接收消息

Webhook（消息回调）会把微信收到的消息发到你的程序。先按自己的情况选一条路径：

你现在的情况	怎么继续
已有能从公网访问的接收服务	按下面的步骤填写地址、测试接收
还没有接收程序或公网地址	打开本地接收示例，按步骤准备程序和地址、完成测试，再返回本页

已有接收服务：

填入自己的公网接收地址，点击「保存并启用 Webhook」。这里填你的地址，不是 Eyun 的 API 地址。
如果配置了来源校验密钥，在接收程序中按个人微信回调规则核对；页面显示新密钥时，先保存并勾选「我已保存 Webhook 密钥」。它与 API 凭证不同。接收程序须保存消息后再返回成功。
如果页面提示未开启接收记录，阅读说明后点击「同意开启接收记录」。开启后会保存收到的消息正文，供控制台核对，需要你明确同意。
保持接收程序运行，点击「发送测试投递」，确认控制台显示测试成功，接收程序也已保存测试内容。
用另一个微信账号，在手机上给当前登录账号发送控制台显示的验证文字。接收程序读到相同文字后，点击「接收端已读到这条真实正文」。

完成标志：你的程序收到真实正文，控制台显示「接入完成」。 测试按钮只检查地址是否可用；用 API 发出的消息也不能代替这一步。

测试卡住时，看回调说明。中途离开后，可从工作台「继续接入」恢复。

调用接口

完成控制台收发测试后，替换以下参数，用 curl 给文件传输助手发一条消息：

参数	填写说明
`{BASE_URL}`	在控制台文档中心复制完整 API 地址，保留路径前缀
`<你的 Auth>`	第 1 步保存的完整 API 凭证
`<你的实例 ID>`	第 2 步登录的实例 `wId`，在实例详情中复制

bash

curl -X POST "{BASE_URL}/sendText" \
  -H "Authorization: Bearer <你的 Auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "wId": "<你的实例 ID>",
    "wcId": "filehelper",
    "content": "第一条测试消息"
  }'

返回 code: "1000"，且手机文件传输助手收到「第一条测试消息」，即调用成功。完整参数和错误说明见发送文本消息。API 凭证只在服务端使用，请勿公开。

下一步

需要更多功能：API 参考。
处理收到的消息：回调说明。
在自己的产品中提供扫码登录：登录接入方式。
准备正式上线：上线检查清单。

快速开始 ​

1. 领取 API 凭证 ​

2. 扫码登录 ​

3. 给自己发消息 ​

4. 接收消息 ​

调用接口 ​

下一步 ​