更新環境 Cookie

向指定環境寫入 Cookie 物件陣列。

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

請求

POST /api/updateCookie

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

JSON 請求體

引數	型別	必填	說明
id	integer	是	瀏覽器環境 ID
cookies	object[]	是	Cookie 物件陣列，不是 JSON 字串或 cookie 配置物件

cURL 示例

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": ".google.com",
      "expirationDate": 1767793010.63343,
      "hostOnly": false,
      "httpOnly": true,
      "name": "SNID",
      "path": "/XXXX",
      "sameSite": null,
      "secure": true,
      "session": false,
      "storeId": null,
      "value": ""
    }
  ]
}'

響應示例

{
  "success": true
}

欄位說明

欄位	型別	說明
cookies[].domain	string	Cookie 域名
cookies[].name	string	Cookie 名稱
cookies[].value	string	Cookie 值
cookies[].path	string	Cookie 路徑
cookies[].expirationDate	number	Unix 秒級過期時間
cookies[].hostOnly / httpOnly / secure / session	boolean	Cookie 屬性
cookies[].sameSite	number / null	保留匯出值及其型別；ApiFox 示例含 1 和 null
cookies[].storeId	null	ApiFox 示例為 null

呼叫說明

• 必須先關閉環境，再呼叫此介面。cookies 傳物件陣列，不能傳 cookie.jsonStr 字串。
• Cookie 欄位結構與 獲取環境 Cookie 一致。保留原有 sameSite 等欄位的值型別；示例過期時間僅為結構演示，請使用有效值。

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