啟動環境

按 ID、名稱或備註啟動環境，獲取用於 CDP 自動化的除錯埠。

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

請求

POST /api/launchBrowser

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

JSON 請求體

引數	型別	必填	說明
id	integer	否	瀏覽器環境 ID
name	string	否	名稱
remark	string	否	備註
tempLaunchArgs	string	否	本次啟動使用的臨時引數，不是持久化 launchArgs 配置

cURL 示例

curl --request POST 'http://127.0.0.1:9000/api/launchBrowser' \
  --header 'api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1
}'

其他請求體示例

{
  "name": "1"
}

{
  "remark": "1"
}

{
  "id": 1,
  "tempLaunchArgs": "--blink-settings=imagesEnabled=false"
}

響應示例

{
  "success": true,
  "data": {
    "debuggingPort": 9222
  }
}

欄位	型別	說明
data.debuggingPort	integer	CDP 除錯埠；用於 Playwright / Puppeteer 連線

呼叫說明

• id、name、remark 三選一；建議使用唯一的 id。名稱或備註重複會導致無法唯一定位環境。
• ApiFox 未定義成功響應欄位；本頁成功示例補充自當前客戶端。除錯埠位於 data.debuggingPort，不是頂層欄位，也不是本地 API 服務埠。
• tempLaunchArgs 僅對本次啟動生效。自動化請連線返回的 CDP 埠，見 Playwright 接入。
• 啟動請求可能等待核心授權與 CDP 就緒；建議客戶端超時設定至少 60 秒。超時後先查詢執行列表，不要立即反覆啟動同一環境。

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