设置云同步开关
开启或关闭某个环境的云同步。开启时默认会立即上传一次,用于把环境包与账号密码信封推到云端。
接口定义: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 |



