典型接入流
API Key、Webhook 回调和请求审计
创建应用
生成 API Key 和 scopes
接入微信号
扫码登录 100 个微信号
调用接口
消息、群、朋友圈异步任务
接收事件
Webhook 签名与重试
联系人
联系人同步、资料更新、好友申请通过与拒绝。
群
群列表、群成员、群二维码和群操作异步任务。
朋友圈
朋友圈读取、发布、点赞、评论和互动检查。
从拿 key 到上线联调
第一版先覆盖客户真正要开始接入的路径:控制台创建应用、拿 API Key、配置 IP 白名单、接收 Webhook、用 request_id 排障。
Bearer Token
数据库只保存 digest,明文只展示一次。
Scope 权限
按账号、消息、联系人、群、朋友圈拆分权限。
幂等写入
写请求支持 Idempotency-Key,避免重复执行。
审计日志
每次请求都记录 request_id、耗时和错误码。