更新環境
按環境 ID 修改名稱或代理配置。
介面定義:ApiFox POST · 核對日期:2026-10-21。
請求
http
POST /api/updateBrowser使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示,必須替換為實際埠;認證說明見 概述。
JSON 請求體
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 瀏覽器環境 ID |
name | string | 否 | 名稱 |
proxy | object | 否 | 代理配置物件 |
proxy.mode | integer | 否 | 0:預設;1:系統;2:自定義 |
proxy.value | string | 否 | 代理配置值,示例為空字串 |
proxy.protocol | string | 否 | 代理協議,如 HTTP、HTTPS、SOCKS5 |
proxy.host | string | 否 | 代理伺服器地址 |
proxy.port | string | 否 | 代理埠,按 ApiFox 定義傳字串 |
proxy.user | string | 否 | 代理使用者名稱;無認證時為空字串 |
proxy.pass | string | 否 | 代理密碼;無認證時為空字串 |
proxy.API | string | 否 | 動態代理提取 URL,不使用時為空字串 |
cURL 示例
bash
curl --request POST 'http://127.0.0.1:9000/api/updateBrowser' \
--header 'api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 84,
"name": "環境666",
"proxy": {
"mode": 2,
"value": "",
"protocol": "SOCKS5",
"host": "127.0.0.1",
"port": "6000",
"user": "",
"pass": "",
"API": ""
}
}'響應示例
json
{
"success": true
}呼叫說明
- ApiFox 當前公開的更新欄位為
id、name、proxy;id必填。代理欄位請按完整物件準備,避免省略已有認證資訊。
請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊,見 錯誤碼與排查。



