API 参考

Eyun API 使用 HTTP POST 和 JSON 完成微信实例登录、消息收发、联系人协作与内容运营。首次接入先在控制台跑通真实消息，再把同一个 Auth 和实例 wId 接入后端。

与企业微信 API 的关系

本页是微信个人号 API。要接企业微信里的客户、客户群与企业成员，请看并列的企业微信 API 文档，凭证与实例互不通用。

	微信个人号 API	企业微信 API
接入对象	个人微信账号的好友与群	企业外部联系人（客户）、客户群与企业成员
开通方式	控制台自助开通，7 天免费试用	企微控制台自助开通，可以试用
在线调试	个人微信在线调试	企业微信在线调试
实例标识	`wId`	`appid`
路径前缀	`/…`	`/wx-api/api/<模块>/…`

接入状态

你已经完成	接下来做什么
还没有开通	按快速开始开通并保存 API 凭证
已开通，但微信未登录	按扫码登录继续
微信已在线	完成收发测试，分别确认手机和接收服务收到消息
已完成收发测试	复制请求到代码，再选择下方业务接口

请求约定

项目	约定
Base URL	从控制台文档中心复制完整 API Base URL，保留路径前缀，填入 `{BASE_URL}`
请求方法	除特殊说明外均为 `POST`
请求格式	`Content-Type: application/json`
推荐认证	`Authorization: Bearer <API 凭证>`
成功码	`"code": "1000"`
失败码	`"code": "1001"`

新默认应用在控制台「应用凭证」页领取一次完整 Auth 并保存；已有应用使用自己保存的完整凭证，掩码不能用于调用。采用开发者账号密码鉴权时，按 API 凭证中的对应流程取得凭证。

bash

curl -X POST "{BASE_URL}/sendText" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyk_your_auth" \
  -d '{
    "wId": "你的登录实例ID",
    "wcId": "filehelper",
    "content": "Hello from Eyun"
  }'

通用响应

json

{
  "code": "1000",
  "message": "成功",
  "data": {}
}

code = "1000" 只表示接口请求成功。查询在线状态、异步任务等接口还需要继续判断 data 中的业务状态。

接口分类

认证与实例

目标	推荐入口
了解 Auth 和登录方式	API 凭证
在自己后台集成登录	Step 1：开发者账号鉴权 → Step 2：获取二维码 → Step 3：执行登录
查询与恢复实例	在线状态 · 断线重连

消息与 Webhook

目标	推荐入口
发送消息	文本 · 图片 · 文件 · 视频 · 小程序
接收事件	设置回调 · 事件索引 · 完整字典
转发已有消息	文件 · 图片 · 视频

联系人、群聊与标签

模块	常用接口
联系人	初始化通讯录 · 联系人列表 · 联系人详情
好友操作	搜索 · 添加 · 备注
群聊	创建群 · 群详情 · 群成员
标签	创建 · 修改 · 列表

朋友圈、视频号与收藏

模块	常用接口
朋友圈	查询 · 发文字 · 发图片 · 互动
视频号	搜索 · 主页 · 发布 · 私信
收藏	列表 · 详情 · 删除

媒体与文件

目标	常用接口
下载消息资源	文件 · 图片 · 语音 · 视频
CDN	下载 · 上传图片 · 上传视频

错误与诊断

目标	常用入口
网络调整	设置自定义代理 · Aid 本地代理
排查问题	错误码与排查 · 常见问题

上线前

完成接口联调后，核对 API 使用与安全、Webhook 可靠性和上线检查清单。

API 参考 ​

与企业微信 API 的关系 ​

接入状态 ​

请求约定 ​

通用响应 ​

接口分类 ​

认证与实例 ​

消息与 Webhook ​

联系人、群聊与标签 ​

朋友圈、视频号与收藏 ​

媒体与文件 ​

错误与诊断 ​

上线前 ​