查詢雲端同步狀態
查詢某個環境的雲端同步開關與帳號狀態。介面只讀本機儲存的狀態,不會向 OSS 或 WebDAV 發起任何請求,可以放心在輪詢或健康檢查裡呼叫。
介面定義:GET · 核對日期:2026-11-19。
請求
http
GET /api/getCloudSyncStatus?id=1
api-key: REPLACE_WITH_LOCAL_API_KEY需保持客戶端執行並已登入會員帳號。從客戶端 API 頁面複製實際本機服務地址和 api-key;API 埠動態分配,不是瀏覽器 CDP 埠。參見概述與鑑權。
Query 引數
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 環境 ID,正整數;從環境列表獲取 |
cURL
bash
BASE_URL='http://127.0.0.1:REPLACE_WITH_API_PORT'
API_KEY='REPLACE_WITH_LOCAL_API_KEY'
curl --get "${BASE_URL}/api/getCloudSyncStatus" \
--header "api-key: ${API_KEY}" \
--data-urlencode 'id=1'響應範例
json
{
"success": true,
"data": {
"id": 1,
"enabled": true,
"cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"provider": "oss",
"loggedIn": true,
"vip": true,
"hasSyncPassword": true
}
}| 欄位 | 型別 | 說明 |
|---|---|---|
data.enabled | boolean | 該環境的雲端同步開關是否開啟 |
data.cloudId | string | 雲端環境 ID;從未同步過的環境可能為空字串 |
data.provider | string | 該環境使用的儲存提供方:oss 或 webdav |
data.loggedIn | boolean | 客戶端當前是否已登入 |
data.vip | boolean | 當前帳號是否具備會員許可權(雲端同步依賴會員) |
data.hasSyncPassword | boolean | 是否已設定同步密碼;未設定時無法透過密碼恢復備份 |



