| 方法 | 路径 / 参数 | 作用 |
| GET |
/ |
状态页:登录态、缓存统计、快捷操作(每 5 秒自动刷新) |
| GET |
/login |
扫码登录页:展示企业微信登录二维码,登录成功后自动跳回状态页 |
| GET |
/api/status |
登录状态、二维码信息、最近校验/采集时间、缓存统计(JSON) |
| GET |
/api/login/qr.png |
当前登录二维码图片(PNG),未生成时返回 404 |
| POST |
/api/login/refresh |
强制重新发起登录、重新生成二维码 |
| GET |
/api/groups?keyword=&page=1&page_size=50 |
群列表分页查询,keyword 按群名模糊搜索 |
| GET |
/api/all?start=&end=&limit=&with_messages_only=true |
全部群 → 聊天记录:按群名分组一次返回全量;limit 限制每群条数,with_messages_only=false 时包含无消息的群 |
| GET |
/api/chat/records?group=群名&start=&end=&page=1&page_size=200 |
按群名(或 chat_id)一次返回群信息 + 该群聊天记录 |
| GET |
/api/groups/{chat_id}/messages?start=&end=&page=1&page_size=200 |
按 chat_id 查询该群的聊天记录(分页) |
| GET |
/api/groups/{chat_id}/export.csv |
导出指定群的聊天记录为 CSV(含发送时间、发送人、类型、内容) |
| POST |
/api/sync/groups |
立即同步客户群列表 + 存档群列表(需登录态有效) |
| POST |
/api/sync/messages?chat_id= |
拉取消息元数据(不含正文);不传 chat_id 则同步全部群 |
| POST |
/api/sync/content |
用无头浏览器抓取聊天正文与图片(依赖企微「会话存档」登录,耗时约 20–60 秒) |
| GET |
/media/{路径} |
读取本地缓存的图片/附件文件 |