建立環境

建立新的瀏覽器環境，返回新環境 ID。

介面定義：ApiFox POST · 核對日期：2026-10-21。

請求

POST /api/addBrowser

使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示，必須替換為實際埠；認證說明見 概述。

JSON 請求體

引數	型別	必填	說明
name	string	是	名稱
group	string[]	是	分組值；建立環境時傳字串陣列，可從現有配置確認具體值
chrome_version	integer	是	Chromium 大版本號；先查詢本地可用核心
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，不使用時為空字串
homepage	object	是	主頁配置物件
homepage.mode	integer	是	0：關閉；1：使用指定主頁
homepage.value	string	是	主頁 URL

巢狀欄位的必填標記表示在其父物件內必填。

cURL 示例

curl --request POST 'http://127.0.0.1:9000/api/addBrowser' \
  --header 'api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": " 環境1",
  "group": [
    "1147"
  ],
  "chrome_version": 132,
  "proxy": {
    "mode": 2,
    "value": "",
    "protocol": "SOCKS5",
    "host": "127.0.0.1",
    "port": "6001",
    "user": "",
    "pass": "",
    "API": ""
  },
  "homepage": {
    "mode": 1,
    "value": "https://baidu.com"
  }
}'

響應示例

{
  "success": true,
  "data": {
    "id": 85
  }
}

呼叫說明

• 必填項按照 ApiFox Schema 整理。group 是字串陣列，proxy 是物件，proxy.port 是字串。
• 表格中的巢狀欄位位於對應物件內，不能展開為 JSON 頂層欄位。示例中的分組、代理端點和核心版本需替換為你本機的實際值。
• 指紋返回值見 環境引數說明。請按本頁公開請求欄位建立，不要直接把完整環境響應全部回傳。

請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊，見 錯誤碼與排查。