Apidog 的 Cookie 管理器可讓你檢視、建立、編輯及管理與各種網域相關聯的 Cookie。這些 Cookie 會儲存在 Apidog 中,並在向其相關聯的網域發出請求時自動包含在內。本指南說明如何有效管理 Cookie 以進行 API 測試。了解 Cookie#
Cookie 是由網站傳送並由使用者的網頁瀏覽器在使用者瀏覽時儲存在使用者電腦上的一組資料。Cookie 被設計為一種可靠的機制,讓網站能記住具狀態的資訊(例如線上商店購物車中新增的商品),或記錄使用者的瀏覽活動。Cookie 組成#
| 組成 | 說明 |
|---|
| 網站名稱 | 建立 Cookie 的網域 |
| 使用者 ID | 使用者的唯一識別碼 |
當你返回某個網站時,該網站可以讀取 Cookie 來記住你和你的偏好設定,並據此調整其內容。如果沒有 Cookie,你離開網站後就需要重新登入,或是在離開頁面後重新建立購物車。Cookie 管理流程#
| 動作 | 目的 | 存取方式 |
|---|
| 檢視 Cookie | 查看不同網域的所有 Cookie | 從右下角開啟 Cookie 管理器 |
| 建立 Cookie | 為網域新增 Cookie | 在 Cookie 管理器中點擊「+ New」 |
| 編輯 Cookie | 修改現有 Cookie 屬性 | 選取 Cookie,進行變更 ,點擊「Save」 |
| 刪除 Cookie | 移除特定 Cookie | 點擊 Cookie 旁的「Delete」 |
| 全部清除 | 移除所有 Cookie 和網域 | 在 Cookie 管理器中點擊「Clear All」 |
| 傳送 Cookie | 自動在請求中包含 Cookie | Cookie 會出現在相符網域的 Headers 分頁中 |
使用 Cookie 管理器#
在 Apidog 介面的右下角,你可以看到「 Cookies」按鈕。點擊它以開啟 Cookies 彈出視窗。檢視 Cookie#
在 Cookies 視窗中,你可以看到網域及其相關 Cookie 的清單。每個 Cookie 都會顯示其主要屬性,包括名稱、值、網域、路徑和到期設定。建立 Cookie#
若要為網域建立新的 Cookie,請點擊「+ New」。| 屬性 | 說明 | 範例/備註 |
|---|
| Domain | Apidog 將傳送 Cookie 的網域 | example.com(不要包含通訊協定) |
| Name | Cookie 的名稱 | session_id, user_token |
| Value | Cookie 的值 | abc123xyz, user@example.com |
| Path | Cookie 限定的 URL 路徑 | / 會將 Cookie 傳送至該網域內的所有請求 |
| Expires | 超過此日期與時間後,Cookie 將不再被傳送 | 2026-12-31 23:59:59 |
| MaxAge | Cookie 的到期時間(以秒為單位) | 3600(1 小時)、86400(1 天) |
| HttpOnly | 表示 Cookie 無法被用戶端指令碼存取 | 此 Cookie 只會包含在請求的 Cookie 標頭中 |
| Secure | Cookie 只會透過安全連線傳送 | 僅在 URL 以 https:// 開頭時傳送 |
選擇 Save,將 Cookie 儲存在 Apidog Cookie 管理器中對應的網域下。編輯與刪除 Cookie#
編輯 Cookie#
刪除 Cookie#
| 動作 | 執行方式 | 使用情境 |
|---|
| 刪除單一 Cookie | 點擊 Cookie 旁的「Delete」 | 移除特定不需要的 Cookie |
| 清除所有 Cookie | 在 Cookie 管理器中點擊「Clear All」 | 重新開始或清理測試資料 |
隨請求傳送 Cookie#
每當你向已新增 Cookie 的網域 發出請求時,該 Cookie 會自動出現在請求的 Headers 分頁中。如果看不到 Cookie,請選擇「hidden」以顯示自動產生的標頭。你無法在 Headers 分頁中直接覆寫 Cookie 標頭。若要修改 Cookie,請使用 Cookie 管理器,或刪除 Cookie 並手動設定請求標頭。在傳送請求之前,Apidog 會合併 Cookie 管理器中新增的 Cookie 與 Headers 分頁中的 Cookie。
最佳實務#
使用描述性名稱:讓 Cookie 名稱清楚且有意義,以便更容易管理
設定適當的到期時間:使用 Expires 或 MaxAge 來控制 Cookie 的生命週期
保護敏感 Cookie:為驗證 Cookie 啟用 Secure 和 HttpOnly 旗標
依網域整理:依各自的網域整理 Cookie,以獲得更好的測試工作流程