Files
group_fqcd_jr/docs
lzf_0626 ff37b0b476 docs(40): 记录知识治理端点的两处接口差异
联调时踩到并查明(更正前一版判断:不是接口故障,是调用方解包方式不对):

1) GET /api/v1/knowledge/list **不套 data 信封**,直接返回 {"items": [...], "count": N},
   而多数端点返回 {"code":…, "data": {…}}。按 data.items 解包会拿到 0 条,
   看着像"库里没数据"——我据此误判过一次,也因此在重灌时没能用列表接口批量删除,
   改为按 id 逐个 DELETE。
2) 上传是 POST /api/v1/knowledge/upload(/documents 会 405);
   DELETE /api/v1/knowledge/{id} 的语义是标记 expired + 投向量删除事件,不是物理删除。

两条都写进验收清单的"通用预期",避免下一个人重复踩。
2026-09-13 20:26:56 +08:00
..
2026-09-13 18:31:38 +08:00