lami/lami-base-v1/backend/tests_python/doc_qiwei_swagger_live.md

Swagger 模块 1～2 真实联调速查

1-健康检查（不必重复联调）

接口	测法
GET /api/health	Execute，应 status: ok，modules 含 qiwei、staff

自动化：test_01_health.py（run_all 已含）。

---

2-企微（需 .env 的 QIWEI_TOKEN、QIWEI_GUID`）

已覆盖（test_13，可不再手点）

接口	说明
GET /qiwei/staff/{guid}/status	在线状态
POST /qiwei/staff/batch-status	批量状态
POST /qiwei/sync	同步消息
POST /qiwei/proxy + getRoomList	群分页（可为空）

新增真实联调（test_19，用 QIWEI_ROOM_IDS）

接口	说明
POST /qiwei/webhook	用真实 guid + roomId 登记 docid
GET /qiwei/messages	查已存消息
GET /qiwei/room-docs	台账列表 / 按 roomId
GET /qiwei/room-doc-anomalies	异常列表
PUT /qiwei/room-doc-anomalies/{roomId}/resolve	解决多表异常

Swagger 手测 webhook 示例

POST /api/qiwei/webhook：

{
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "cmd": 15000,
      "guid": "你的QIWEI_GUID",
      "msgType": 13,
      "fromRoomId": "10865515454476837",
      "msgData": {
        "linkUrl": "https://doc.weixin.qq.com/txdoc/excel?docid=DOC_SWAGGER_test001",
        "title": "沟通记录"
      },
      "timestamp": 1716200000
    }
  ]
}

然后 GET /api/qiwei/room-docs?roomId=10865515454476837。

---

一键跑企微真实联调：

cd backend/tests_python
python -m pytest -m qiwei_live -v