刚接触接口的人常问到底能做什么。与其按功能罗列不如按接口性质分三类读类拉数据、写类执行动作、事件类被动接收。三类接口的调用约束完全不同——读类怕超频、写类怕触发风控、事件类怕丢。按这个视角盘点能做什么、怎么用、什么不能做就清楚了。一、读类接口好友、群、消息记录读类接口不改动任何状态只拉数据。好友列表与详情——分页拉全量好友拿 wxid、昵称、备注、标签。群列表与群成员——拿群 ID、群名、成员清单。消息记录——按会话拉历史消息用于存档和检索。读类接口的约束是调用频率。几千好友全量拉一遍要分页几十次频繁全量拉会触发限流。正确做法是首次全量、之后增量结果本地建索引查询走本地。好友列表的分页拉取方式在 Eyun 开发文档 中有说明。二、写类接口通过好友、发消息、群操作写类接口会改变微信侧状态是高危操作区。通过好友申请——传申请 ID 确认通过。发消息——文本、图片、文件、视频按类型传参。群操作——拉人、踢人、改群名、发公告、撤回消息。写类接口的约束不是能不能调是多久调一次。发消息间隔最低 3 秒、批量操作打散到不同时间段、单条文本不超过 500 字。写接口的返回值要逐条检查——批量拉群时可能部分成功部分失败失败的进重试队列。消息发送的类型参数和限流说明见 Eyun 官网。三、事件类接口消息、申请、成员变动事件类是被动接收不是主动调用——配置 Webhook 地址平台把事件推过来。消息事件——单聊、群聊的新消息。申请事件——好友申请、入群邀请。变动事件——群成员进出、被踢出群。事件类接口的约束是接收端必须可靠回调要在时限内返回 ACK、要做幂等去重、要做验签。事件推送是整个自动化体系的触发源这一层不稳上层所有逻辑都是空中楼阁。三类接口能力对照类别代表接口核心约束典型用途读类好友列表、群成员、消息记录分页限频建索引、做报表写类发消息、通过申请、拉群间隔≥3秒打散自动回复、批量运营事件类消息回调、申请回调ACK幂等验签触发业务流常用组合的最小示例class CapabilityDemo: def __init__(self, api): self.api api # 读类分页拉好友 def list_friends(self): friends, cursor [], None while True: r self.api.get(/friend/list, params{cursor: cursor, limit: 200}).json() friends r[items] cursor r.get(next_cursor) if not cursor: break time.sleep(1) # 读接口也留间隔 return friends # 写类通过申请并发欢迎语 def accept_and_welcome(self, req_id, wxid): self.api.post(/friend/accept, {req_id: req_id}) time.sleep(3) # 写接口间隔 self.api.post(/send, { wxid: wxid, content: 你好已通过好友申请 }) # 事件类回调入口只做分发 def on_event(self, event): handlers { message: self.on_message, friend_request: self.on_friend_request, member_change: self.on_member_change, } h handlers.get(event.get(type)) if h: h(event) # 各处理器独立落地建议盘点能力按读、写、事件三类分——读类建本地索引别反复全量拉写类控制间隔和批量节奏事件类把 ACK、幂等、验签三件事做扎实。三类接口组合起来就是完整自动化链路事件触发、读类取上下文、写类执行动作。具体每个接口的字段和限制以Eyun这类个人微信API平台 的开发文档为准业务编排逻辑在自建服务实现。