{"doc":"接口按 /api/\u003c模块\u003e/\u003c动作\u003e 划分，完整目录见 GET /api/system/info","groups":[{"group":"system","desc":"系统与健康检查","auth":"public","routes":["GET  /api/system/health          健康检查（探活用，公开）","GET  /api/system/info            服务信息与接口目录（公开）","GET  /api/system/security        安全能力（公开）","GET  /api/system/metrics         运行指标（需令牌）"]},{"group":"auth","desc":"身份与令牌","auth":"public + token","routes":["POST /api/auth/login              {\"userId\":\"u1\",\"name\":\"小明\",\"secret\":\"\u003c注册密钥\u003e\"} → 用户令牌","POST /api/auth/admin/login        {\"username\":\"admin\",\"secret\":\"\u003c管理密钥\u003e\"} → 管理令牌（并下发 HttpOnly Cookie）","GET  /api/auth/profile           当前身份（需令牌）","POST /api/auth/refresh           令牌续期（需令牌）","POST /api/auth/logout            注销并清除 Cookie（需令牌）"]},{"group":"user","desc":"用户资料","auth":"token","routes":["GET  /api/user/list              用户列表（含在线状态）"]},{"group":"presence","desc":"在线状态","auth":"token","routes":["GET  /api/presence/online        在线用户与连接数","GET  /api/presence/snapshot      全量用户快照"]},{"group":"chat","desc":"聊天","auth":"token","routes":["GET  /api/chat/history           历史消息 ?peer=u2 | ?room=lobby\u0026limit=50","POST /api/chat/send               {\"to\":\"u2\",\"room\":\"lobby\",\"text\":\"hi\"} 发送者取自令牌","GET  /api/chat/groups            群组列表","POST /api/chat/bot                {\"to\":\"u2\",\"text\":\"hi\"} 以小助手身份发送"]},{"group":"notify","desc":"通知","auth":"token","routes":["POST /api/notify/push             {\"to\":\"\",\"level\":\"info\",\"title\":\"标题\",\"body\":\"内容\"} 默认只推给自己"]},{"group":"admin","desc":"管理后台","auth":"admin","routes":["GET  /api/admin/overview         总览：连接数/在线数/消息数/运行时长","GET  /api/admin/users            用户明细（在线状态、连接数）","POST /api/admin/notify/broadcast  {\"level\":\"info\",\"title\":\"维护通知\",\"body\":\"...\"} 全员广播"]},{"group":"demo","desc":"联调示例（非业务接口，可删）","auth":"token","routes":["GET  /api/demo/hello             ?name=Flutter","POST /api/demo/echo               {\"message\":\"你好\"}"]},{"group":"websocket","desc":"实时通道","auth":"token","routes":["GET  /wss?token=\u003c令牌\u003e\u0026avatar=🙂\u0026device=android   WebSocket 入口，握手时校验令牌"]}],"service":"toolapp-backend","version":"0.4.0"}