API 参考

80+ 端点，完整的 REST API

认证

所有 /api/v1/ 端点（/health 除外）需要 Bearer Token 认证。

Authorization: Bearer <token>

速率限制

速率限制：600 请求/分钟

端点列表

认证

方法	路径	说明
POST	/api/v1/auth/login	登录获取 Token
POST	/api/v1/auth/logout	登出
GET	/api/v1/auth/status	认证状态

备份源

方法	路径	说明
GET	/api/v1/sources	列出备份源
POST	/api/v1/sources	创建备份源
GET	/api/v1/sources/{id}	获取备份源
PUT	/api/v1/sources/{id}	更新备份源
DELETE	/api/v1/sources/{id}	删除备份源

备份操作

方法	路径	说明
POST	/api/v1/backup/run	触发备份
GET	/api/v1/backup/progress	备份进度
GET	/api/v1/backup/state	备份状态
POST	/api/v1/backup/cancel	取消备份

快照

方法	路径	说明
GET	/api/v1/snapshots	列出快照
GET	/api/v1/snapshots/{id}	快照详情
GET	/api/v1/snapshots/changes	快照变更

文件浏览与历史

方法	路径	说明
GET	/api/v1/files	浏览文件
GET	/api/v1/history	版本历史
GET	/api/v1/history/content	文件内容
GET	/api/v1/history/diff	差异对比
POST	/api/v1/history/restore	恢复文件

仓库

方法	路径	说明
GET	/api/v1/repositories	列出仓库
POST	/api/v1/repositories	创建仓库
GET	/api/v1/repositories/{id}	仓库详情
PUT	/api/v1/repositories/{id}	更新仓库
DELETE	/api/v1/repositories/{id}	删除仓库

云存储

方法	路径	说明
GET	/api/v1/cloud/backends	列出云后端
POST	/api/v1/cloud/backends	创建云后端
POST	/api/v1/cloud/test	测试连接

保留与 GC

方法	路径	说明
POST	/api/v1/retention/apply	应用保留策略
POST	/api/v1/retention/gc	运行 GC
POST	/api/v1/retention/verify	验证备份

监控

方法	路径	说明
GET	/api/v1/oversight/health	健康检查
GET	/api/v1/oversight/alerts	告警列表
POST	/api/v1/oversight/patrol	运行巡逻

加密密钥

方法	路径	说明
POST	/api/v1/keys/export	导出密钥
POST	/api/v1/keys/import	导入密钥