本地自動化 API
在側邊欄開啟「自動化 API」，點選「啟動本地 API」。Prism 會顯示 API 位址（127.0.0.1 上的隨機連接埠）和本次存取權杖；權杖只顯示一次，停止 API 後即失效。
| 請求 | 作用 |
|---|---|
| GET /v1/status | 服務狀態 |
| GET /v1/profiles | 列出環境：編號、名稱、分組、標籤、狀態、最近開啟時間 |
| GET /v1/profiles/{id}/status | 查詢單一環境狀態 |
| POST /v1/profiles/{id}/start | 啟動環境，代理預檢與同時啟動數限制和介面相同 |
| POST /v1/profiles/{id}/close | 關閉環境 |
| POST /v1/profiles | 建立單一環境，可設定名稱、分組、代理和指紋（0.3.22 起） |
| POST /v1/profiles/batch | 一次建立 1–50 個環境，全部驗證通過才會儲存（0.3.22 起） |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- 只接受來自本機的請求：Host 必須與 API 位址一致；帶有瀏覽器 Origin 標頭或查詢參數的請求會被拒絕（只有建立環境的端點接受 JSON 請求本文），網頁無法直接呼叫。
- 每分鐘最多 120 個請求（與 MCP 本地橋接共用）。
- API 可以建立、查詢、啟動和關閉環境，不能修改或刪除環境，也不能讀取瀏覽器資料；API 本身不提供 Puppeteer / Playwright 除錯端點（Windows 版為了內部控制，會在 127.0.0.1 上開啟隨機除錯連接埠，這不是公開介面）。
- 「緊急停止」會關閉由 API 啟動的環境；呼叫記錄會寫入本機稽核記錄。
請求規則、傳回欄位、錯誤碼和 Python / Node.js 範例，詳見本地 API 文件。
本地排程工作
| 設定 | 可選值 |
|---|---|
| 執行動作 | 啟動環境 / 關閉環境 |
| 重複方式 | 僅一次 / 每天 / 每週（可多選週日至週六） |
| 執行時間 | 本機時間與時區 |
| 錯過的工作 | 24 小時內補執行一次 / 跳過本次 |
| 失敗重試 | 0–3 次，重試間隔 1–60 分鐘 |
- 排程工作只在 Prism 執行期間運作，沒有背景常駐程式；每 15 秒檢查一次到期的工作，最多同時執行 2 個。
- 可以用「立即執行」測試工作；被排程工作引用的環境，需要先解除該工作才能刪除。
- Pro 授權失效時會暫停排程，工作仍會保留，可繼續停用或刪除。
組合使用範例
上班自動開好工作環境
每天 09:00 啟動常用環境，下班前關閉，減少手動操作和誤開。
用指令碼批次啟動與關閉
在自己的指令碼裡先呼叫 GET /v1/profiles 找到環境 ID，再依序啟動，啟動邏輯與介面一致。
交給 AI 繼續
環境啟動後，由 MCP 在你授權的環境裡讀取頁面、完成後續步驟。
常見問題
- 可以執行自訂指令碼或 RPA 流程嗎？
- 排程工作只支援啟動和關閉環境，API 也不執行指令碼。需要頁面層級的操作時，可使用 Pro 的 MCP，或自行在環境中安裝擴充功能。
- 相容其他指紋瀏覽器的 API 嗎？
- 不相容。Prism 使用自己的本地介面，路徑見上表。
- 關閉 Prism 後排程工作還會執行嗎？
- 不會。排程工作需要 Prism 保持執行；錯過的工作可依設定在 24 小時內補執行一次。