动手写代码之前有四个概念必须先搞清楚。这四个概念不明白后面每个接口都会调得稀里糊涂。一、标识体系wId 和 Token 分别是什么API 体系里有两个关键标识。Token 是你这个应用的身份凭证调用所有接口都要带上证明是哪个开发者在调。wId 是一个微信实例的标识证明操作的是哪个微信号。一个 Token 下可以有多个 wId多开场景接口调用时两个都要传Token 放请求头鉴权wId 放请求参数里指定实例。混淆这两个是新手最常见的报错原因。二、收发模型主动请求和事件回调程序和微信之间有两条方向相反的通道。主动请求是你调接口发消息、查列表HTTP 调用即时返回结果。事件回调是微信把事件推给你新消息、好友申请、掉线你需要提前配好 Webhook 地址。回调有个硬规则5 秒内必须返回响应否则触发重试最多 3 次。这意味着回调里不能干重活处理逻辑要丢异步队列。三、消息结构回调数据长什么样回调消息是 JSON关键字段有消息类型文本、图片、群消息、发送人标识fromUser、内容content类型不同含义不同、群 ID群消息才有、时间戳。发消息sendText则要提供 wId、toUser、content 三个必填参数。收发两端的数据结构对上号消息闭环才能跑通。四、错误处理返回码怎么读接口返回 JSON 里带 code 字段1000 成功、1001 参数错误、1002 Token 过期、1004 频率限制。每个非 1000 都有对应处理方式——1002 要重新获取 Token1004 要退避等待后重试。不读返回码直接假设成功是线上事故的常见来源消息没发出去程序却以为发了。四个入门概念对照概念核心内容新手易错点标识体系Token 鉴权、wId 指实例两者混淆、wId 用错实例收发模型主动请求 Webhook 回调回调里做重活导致超时消息结构回调字段、发送三参数fromUser/toUser 搞反错误处理1000/1001/1002/1004不判断 code 直接当成功最小验证代码import requests # 1. 主动请求发消息理解 Token wId 三参数 r requests.post(https://api.eyunz.com/v1/sendText, headers{Authorization: 你的Token}, json{wId: 你的wId, toUser: 文件传输助手或自己的wxid, content: 入门测试}) print(r.json()) # 4. 读返回码看到 code1000 就是通了 # 2. 事件回调配好地址后5秒内响应 # app.post(/webhook) # def cb(): return {code: 1000}落地建议入门最完整的说明在 Eyun 开发文档。建议学习顺序先搞懂 Token 和 wId5 分钟用最小代码发一条消息验证鉴权再配回调收一条消息理解 5 秒规则最后研究错误码处理。四个概念都用代码验证过一遍再开始正式开发会少踩很多坑。平台开通入口见 Eyun 官网。