核心 API 參考

在 Mbbrowser 自動化流程中，最常用的操作集中在環境的管理（啟動、停止、狀態查詢）。以下是基於 ApiServer 的 HTTP 接口詳解。

1. 啟動環境 (Start Session)

接口地址: POST /api/v1/browser/start

請求參數:

• Session_ID (String): 必需。環境的唯一 ID。
• Open_Tabs (Array): 可選。啟動時自動打開的 URL 列表。

返回內容:

{
  "code": 0,
  "message": "success",
  "data": {
    "ws": "ws://127.0.0.1:52134/devtools/browser/...",
    "debug_port": 52134
  }
}

2. 停止環境 (Stop Session)

接口地址: POST /api/v1/browser/stop

請求參數:

• Session_ID (String): 必需。

說明: 調用此接口會關閉對應的瀏覽器進程並同步保存 Cookie 和指紋數據。

3. 查詢環境狀態 (List Sessions)

接口地址: GET /api/v1/browser/list

返回內容: 包含所有環境的當前狀態（運行中/未使用）、分組信息等。

4. 其它常用 API

• /api/v1/browser/active: 查詢當前所有正在運行的環境列表。
• /api/v1/browser/delete: 刪除指定環境及其緩存數據。

---

IMPORTANT

所有接口調用前，請確保 ApiServer.exe 已在後台運行且端口（默認 8186）未被占用。