接口覆盖矩阵

本页把公开 API 按方法、权限、风险和对应文档列出，避免客户端遗漏安全处理。

接口	方法	典型权限	写入/删除	详细文档
/token/get	POST	登录凭据	创建会话	Token
/token/reg	POST	注册验证	创建账号	注册与认证
/token/validate	POST	已有 Token	只读	Token
/token/bind	POST	已有 Token	修改密码绑定	注册与认证
/token/logout	POST	已有 Token	退出会话	Token
/aimedb/reg	POST	用户 Token	生成访问码	访问码
/aimedb/reg-temp	POST	用户 Token	生成临时访问码	访问码
/aimedb/reg-token	POST	用户 Token/验证码	绑定网页登录	访问码
/forward/get	POST	当前账号	只读	配方
/forward/add	POST	当前账号权限	修改配置	配方
/forward/del	POST	当前账号权限	清理配置	配方
/photo/get	POST	用户 Token	只读	相片
/photo/get-file	POST	用户 Token	文件读取	相片
/photo/del-file	POST	用户 Token	删除单张	相片
/photo/del	POST	用户 Token	删除全部	相片
/cache/backup	POST	用户 Token	生成备份	缓存
/cache/restore	POST	用户 Token	恢复数据	缓存
/upload-cache/get	POST	用户 Token	只读	上传缓存
/upload-cache/upload	POST	用户 Token/访问码	上传快照	上传缓存
/upload-cache/get-file	POST	用户 Token	下载快照	上传缓存
/upload-cache/del	POST	用户 Token	删除快照	上传缓存
/user/music/get	POST	用户 Token	只读	用户乐曲数据
/chart/social/get	POST	用户 Token	只读/互动读取	成绩互动
/chart/reaction	POST	用户 Token	点赞/点踩	成绩互动
/chart/comment/add	POST	用户 Token	发布评论	成绩互动
/chart/comment/del	POST	评论权限	删除评论	成绩互动
/chart/comment/reaction	POST	用户 Token	评论互动	成绩互动
/chart/review/request	POST	用户 Token	提交反馈	成绩互动
/chart/review/withdraw	POST	反馈作者	撤回反馈	成绩互动
/chart/review/list	POST	审核权限	只读	成绩互动
/chart/review/history	POST	审核权限	只读	成绩互动
/chart/review/decision	POST	审核权限	审核状态修改	成绩互动
/playlog/get	POST	用户 Token	只读	游玩记录
/player/queue/get	POST	机台权限	只读	机台查卡
/region/get	GET	公开聚合	只读	地区统计
/usage/get	POST	统计权限	只读	公开统计

风险等级

低风险读取

Token 验证、列表读取、地区聚合和用户乐曲读取通常可以自动刷新，但仍需限频。

中风险写入

配方修改、评论、反馈和缓存上传应显示结果并避免重复提交。

高风险操作

删除相片、删除上传缓存、恢复缓存、清理配置和审核决策都必须二次确认，并在请求前保存当前状态。

不应自动公开的内容

客户端不应把完整 Token、访问码、密码、机台凭据、原始错误响应或个人记录上传到第三方日志服务。公开 API 只代表用户可调用的接口，不代表可以绕过账号权限。