← 返回首页
POST /api/repo/getCloudRepoSnapshots

获取云端仓库快照列表

需要认证 需要管理员

接口描述

获取当前用户已登录的云端同步仓库的快照列表，支持分页。

请求参数 (JSON Body)

参数名 类型 必需 描述
page number 是 页码，从 1 开始计数。

返回值

参数名 类型 描述
code number 返回码，0 表示成功
msg string 错误信息，成功时为空字符串
data object 包含快照列表和分页信息的对象。
  • snapshots: object[] - 快照对象数组。每个快照对象的具体字段依赖于云端服务，但通常包含 id (快照ID), timestamp (时间戳), memo (备注), size (大小) 等。
  • pageCount: number - 总页数。
  • totalCount: number - 快照总数量。
请求示例
返回示例

请求示例 (获取第一页)

POST /api/repo/getCloudRepoSnapshots HTTP/1.1
Host: 127.0.0.1:6806
Content-Type: application/json
Authorization: Token YOUR_API_TOKEN_HERE

{
  "page": 1
}

返回示例 (成功)

{
  "code": 0,
  "msg": "",
  "data": {
    "snapshots": [
      {
        "id": "20230501100000-abcdefgh",
        "timestamp": 1682906400000,
        "memo": "Manual backup before update",
        "size": 102400,
        "repoKey": "xxxxxxxx" 
      },
      {
        "id": "20230420153000-ijklmnop",
        "timestamp": 1681975800000,
        "memo": "Daily auto backup",
        "size": 98765,
        "repoKey": "xxxxxxxx"
      }
      // ...更多快照
    ],
    "pageCount": 5,
    "totalCount": 48
  }
}

返回示例 (失败 - 未认证或无管理员权限)

{
  "code": -1, // 或 401, 403 等，具体根据服务端实现
  "msg": "API token is missing or invalid / Admin role required",
  "data": null
}

注意：这是一个社区维护的文档，可能与官方最新版本存在差异。

如果您觉得本文档有帮助，可以考虑赞助支持：爱发电

在线测试