更新環境 Cookie
向指定環境寫入 Cookie 物件陣列。
介面定義:ApiFox POST · 核對日期:2026-10-21。
請求
http
POST /api/updateCookie使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示,必須替換為實際埠;認證說明見 概述。
JSON 請求體
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 瀏覽器環境 ID |
cookies | object[] | 是 | Cookie 物件陣列,整體覆蓋;[] 清空,不可傳 JSON 字串;先關閉環境並備份 |
cURL 示例
bash
curl --request POST 'http://127.0.0.1:9000/api/updateCookie' \
--header 'api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 1,
"cookies": [
{
"domain": ".example.com",
"expirationDate": 4102444800,
"hostOnly": false,
"httpOnly": true,
"name": "SNID",
"path": "/XXXX",
"sameSite": "lax",
"secure": true,
"session": false,
"storeId": null,
"value": "EXAMPLE_COOKIE_VALUE"
}
]
}'響應示例
json
{
"success": true
}目前客戶端回應欄位
| 欄位 | 型別 | 用法 |
|---|---|---|
success | boolean | 請求處理成功標記;不代表每筆資料均已寫入 |
欄位說明
| 欄位 | 型別 | 說明 |
|---|---|---|
cookies[].domain | string | 非空網域,如 .example.com;缺失會跳過該項 |
cookies[].name | string | 非空字串;缺失會跳過該項 |
cookies[].value | string | 非空字串;缺失或為空會跳過該項;勿公開真實 Cookie |
cookies[].path | string | 路徑字串;省略時為 / |
cookies[].expirationDate | number | Unix 秒級正數;無有效值且非 session 時預設為約一年後 |
cookies[].hostOnly / httpOnly / secure / session | boolean | Cookie 屬性 |
cookies[].sameSite | string | 字串 lax、strict、none 或 no_restriction;none 與 no_restriction 均映射為 0 |
cookies[].storeId | null | ApiFox 示例為 null |
呼叫說明
- 必須先關閉環境,再呼叫此介面。
cookies傳物件陣列,不能傳cookie.jsonStr字串。 - Cookie 欄位與覆蓋規則見下方;勿假設匯出結果可無損寫回。
請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊,見 錯誤碼與排查。
全量覆蓋,請先備份
目前客戶端會先清空瀏覽器 Cookie 資料表,再寫入 cookies 陣列中通過檢查的項目,並非增量更新。非陣列會被轉為空陣列,可能清空原有 Cookie;[] 也表示清空。請先關閉環境並備份,避免登入狀態遺失。
目前匯入規則:
- 每筆須有非空
domain、name、value,否則跳過;path預設/。session: true的項目不會寫入。 expirationDate使用 Unix 秒;非 session 記錄若沒有有效正數,預設約一年後。範例僅供結構示意。sameSite請使用lax、strict、none或no_restriction字串。輸入的none和no_restriction均對應 0;未知值與數字不會原樣保留。匯出時 0 顯示為unspecified,因此不保證無損往返。- 無效項目可能跳過;個別寫入錯誤可能只記錄日誌而仍回傳成功。寫入後請重新讀取核對,不要只依賴
success。
Cookie 值通常是登入憑證;請勿公開請求內容、匯出結果或備份。
已啟用雲端同步的環境更新 Cookie 後,客戶端可能延遲觸發背景上傳;介面回傳成功不代表雲端上傳已完成。



