1. 云同步
VirtualBrowser
  • 接入前必读
  • 附录 A：MCP 接口（AI 自动化）
  • 附录 B：常见问题
  • 环境基础
    • 获取浏览器环境列表
      GET
    • 获取浏览器环境列表
      POST
    • 获取环境完整参数
      GET
    • 获取运行中的环境列表
      GET
    • 创建环境
      POST
    • 更新环境
      POST
    • 删除环境
      POST
    • 启动环境
      POST
    • 关闭环境
      POST
  • 环境数据
    • 删除环境数据
      POST
    • 获取环境cookie
      GET
    • 更新环境cookie
      POST
    • 清除环境缓存
      POST
    • 更新环境指纹
      POST
  • 运行与工具
    • 查询当前环境ID是否在运行中
      GET
    • 窗口排列
      POST
    • 获取内核版本信息
      GET
  • 分组管理
    • 获取分组列表
      GET
    • 添加分组
      POST
    • 更新分组名称
      POST
    • 删除分组
      POST
  • 插件管理
    • 获取插件列表
    • 添加插件
    • 删除插件
  • 平台账号
    • 获取环境中平台保存的账号密码
    • 新增环境中平台账号密码
    • 更新环境中平台账号密码
    • 删除环境中平台账号密码
  • 云同步
    • 查询环境云同步状态
      GET
    • 设置环境云同步开关
      POST
    • 删除云端备份
      POST
    • 分页查询云端备份
      GET
    • 恢复为新的本地环境
      POST
  1. 云同步

分页查询云端备份

GET
/api/listCloudBackups
分页查询当前账号在云端的备份列表，并标注每个备份是否已绑定到本地环境。
需要已登录且为会员。返回结果按 cloudId 升序排列。
provider 不传时，使用客户端全局配置中的云同步提供方（oss 或 webdav）
page 默认 1，pageSize 默认 50（最大 1000），两者可单独传
查询参数只接受 provider、page、pageSize，传其他参数会返回 400

异常返回#

场景HTTPcode
参数非法（含未知参数、page/pageSize 不是正整数）400INVALID_PARAMETERS
provider 不是 oss/webdav400INVALID_PROVIDER
选择了 webdav 但客户端未配置400WEBDAV_CONFIG_REQUIRED
未登录401AUTH_REQUIRED
非会员403VIP_REQUIRED
查询云端失败502CLOUD_BACKUP_LIST_FAILED
云同步能力不可用503CLOUD_SYNC_UNAVAILABLE
云端请求超时504REQUEST_TIMEOUT

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/listCloudBackups?provider=oss&page=1&pageSize=50' \
--header 'api-key: your-api-key'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "success": true,
    "data": [
        {
            "cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "name": "环境1",
            "provider": "oss",
            "envSizeBytes": 174763,
            "envSizeMB": "0.17",
            "localIds": [
                1
            ]
        }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 50,
    "provider": "oss"
}
修改于 2026-11-09 10:47:56
上一页
删除云端备份
下一页
恢复为新的本地环境
Built with