POST管理接口
新建 WebDAV 存储后端
本机存储为内置项(id `local`),不可新建。`is_default: true` 会把新后端设为实例默认存储。 密码以 AES-256-GCM 加密落库,密钥派生自实例的 JWT_SECRET。
URL
/api/v1/admin/storage/backends鉴权方式
需要管理员 JWT(Authorization: Bearer <token>)
请求参数
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"name": "坚果云",
"kind": "webdav",
"base_url": "https://dav.jianguoyun.com/dav/verhub",
"username": "[email protected]",
"password": "app-password",
"is_default": true
}响应示例
201 响应
{
"id": "cm8webdav0000000001",
"name": "坚果云",
"kind": "webdav",
"is_builtin": false,
"is_default": true,
"base_url": "https://dav.jianguoyun.com/dav/verhub",
"username": "[email protected]",
"has_password": true,
"password_fingerprint": "3f2a9c1d0b7e4a55",
"part_size_kb": null,
"file_count": 12,
"cdn_origin": {
"scheme": "https",
"host": "dav.jianguoyun.com",
"path_prefix": "/dav/verhub"
},
"created_at": 1760000000,
"updated_at": 1760000000
}POST
