API 概览

所有接口路径前缀为 /api/v1。

响应格式

{ "code": 0, "msg": "", "data": { ... } }

code 按域分组：

范围	域
0	成功
1000-1999	通用错误
2000-2999	认证错误
3000-3999	文件错误
4000-4999	策略错误
5000-5999	文件夹错误

认证方式

大部分接口需要认证。登录后 token 通过 HttpOnly Cookie 自动携带，也支持 Authorization: Bearer <token> 头。

Swagger UI

运行时访问 /swagger-ui 查看完整的交互式 API 文档。

接口列表

• 认证 - 注册、登录、token 管理
• 文件 - 上传、下载、删除、修改
• 文件夹 - 创建、列表、删除、修改
• 管理 - 存储策略 CRUD（需管理员权限）
• 健康检查 - 存活和就绪探针