POST管理接口

新建 WebDAV 存储后端

本机存储为内置项(id `local`),不可新建。`is_default: true` 会把新后端设为实例默认存储。 密码以 AES-256-GCM 加密落库,密钥派生自实例的 JWT_SECRET。

URL

/api/v1/admin/storage/backends

鉴权方式

需要管理员 JWT(Authorization: Bearer <token>)

请求参数

Header 参数

名称类型必填说明
Authorizationstring是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

Try It Out

请求 URL 预览

/api/v1/admin/storage/backends