設定雲端同步開關
開啟或關閉某個環境的雲端同步。開啟時預設會立即上傳一次,用於把環境包與帳號密碼信封推到雲端。
介面定義:POST · 核對日期:2026-11-19。
請求
http
POST /api/setCloudSync
api-key: REPLACE_WITH_LOCAL_API_KEY從客戶端 API 頁面複製實際本機服務地址和 api-key;API 埠動態分配,不是瀏覽器 CDP 埠。參見概述與鑑權。
JSON 請求體
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 環境 ID,正整數 |
enable | boolean | 是 | true 開啟,false 關閉 |
syncNow | boolean | 否 | 開啟時是否立即上傳一次,預設 true;關閉環境同步時忽略 |
wait | boolean | 否 | true 時同步等待上傳完成後才返回;大環境建議保持非同步,避免請求超時 |
cURL
bash
BASE_URL='http://127.0.0.1:REPLACE_WITH_API_PORT'
API_KEY='REPLACE_WITH_LOCAL_API_KEY'
curl --request POST "${BASE_URL}/api/setCloudSync" \
--header "api-key: ${API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"id": 1,
"enable": true,
"syncNow": true,
"wait": false
}'響應範例
json
{
"success": true,
"data": {
"id": 1,
"enabled": true,
"syncTriggered": true
}
}| 欄位 | 型別 | 說明 |
|---|---|---|
data.enabled | boolean | 設定後的開關狀態 |
data.syncTriggered | boolean | 本次是否觸發了立即上傳;syncNow 為 false 或關閉同步時為 false |



