一个 API其实是一整套接口体系。按功能离发消息这个核心的远近画成三个圈盘点起来最直观。一、核心圈——消息收发能力最核心的一圈围绕消息sendText 发文本sendImage 发图片sendFile 发文件以及视频、语音、链接、名片、小程序等消息类型。收消息靠 Webhook 回调消息记录接口查历史。核心圈解决程序和微信能对话。90% 的机器人项目只用核心圈的能力就够了。这一圈的接口调用最频繁返回码判断1000 成功、1004 限频也要最熟练。二、扩展圈——人和群的管理能力往外一圈围绕关系好友操作添加、通过、删除、备注、联系人同步群操作建群、拉人、踢人、群信息好友事件和群事件回调。扩展圈解决程序能管理人。客服欢迎、群运营、私域管理这类场景核心圈加上扩展圈就完整了。这一圈有写操作加人、踢人调用要谨慎。三、外围圈——状态与高级能力最外一圈围绕监控和进阶实例状态回调在线、掉线、错误码体系、朋友圈相关能力、多媒体素材处理。外围圈解决系统跑得稳、玩得深。状态监控是生产环境必备——掉线不可怕不知道掉线才可怕。朋友圈等高级能力按业务需要选用。三圈能力盘点能力圈包含能力解决什么典型项目核心圈各类消息发送、回调接收、历史记录程序和微信对话聊天机器人、自动回复扩展圈好友管理、群管理、事件回调程序管理人私域运营、群管机器人外围圈状态监控、错误码、朋友圈、素材处理跑稳、玩深生产级系统、进阶应用核心圈最小调用import requests def api(path, payload): r requests.post(fhttps://api.eyunz.com/v1/{path}, headers{Authorization: TOKEN}, json{wId: WID, **payload}) data r.json() if data.get(code) ! 1000: # 统一错误处理 log_error(path, data) return data api(sendText, {toUser: to, content: 你好}) # 核心圈落地建议能力总览见 Eyun 开发文档。选能力时从核心圈起步跑通消息收发再往外加——项目上线初期核心圈就能验证 80% 的需求。外围圈里唯一建议尽早接的是状态监控它不产生业务价值但能防止业务中断。各接口参数在文档中都有明确说明实例开通见 Eyun 平台。
