butubb
556680c613
58 个接口，按 auth/crawler/creator/data/monitor/settings 分组，逐条列出方法、路径、 是否需要登录、说明、参数（含类型/必填/默认）、请求体 schema；附录展开请求体的字段。 **生成的，不是手写的** —— 手写的接口文档从改代码那天起就开始腐烂，而且烂得无声无息。 `docs/gen_api_doc.py` 只读 app 对象，不连库不起服务。 两处值得说的： * 鉴权**不能从 schema 里读** —— require_auth 是普通依赖不是 security scheme，不会进 OpenAPI 的 security 字段。所以那份「哪些路径免登录」的名单是照着 include_router 核的，而且 auth 那一组不能一刀切（/me 和 /password 各自另有保护）。 * 生成完**顺手验一遍表格**：参数类型里的 `integer | null` 到处是，一个没转义的竖线 就会把整张表切歪，而 markdown 不报错、只是安静地多一格。验过这个检查确实会拦。 接口的响应没有结构可列 —— 它们返回普通 dict，没声明 response_model。