管理 Cookie

Apidog 的 Cookie 管理器允许你查看、创建、编辑和管理与各个域名关联的 Cookie。这些 Cookie 存储在 Apidog 中，并在向其关联域名发送请求时自动包含在请求中。本指南说明如何有效管理用于 API 测试的 Cookie。

Cookie 是由网站发送并在用户浏览时由用户的 Web 浏览器存储在用户计算机上的一组数据。Cookie 旨在成为一种可靠机制，用于让网站记住有状态信息（例如在线商店中添加到购物车的商品），或记录用户的浏览活动。

Cookie 通常包含两项基本信息：

组成部分	描述
站点名称	创建 Cookie 的域名
用户 ID	用户的唯一标识符

当你返回某个站点时，它可以读取 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 选项卡中

在 Apidog 界面的右下角，你可以看到一个“ Cookies”按钮。点击它即可打开 Cookies 弹出窗口。

在 Cookies 窗口中，你可以看到域名及其相关 Cookie 的列表。每个 Cookie 都会显示其关键属性，包括名称、值、域名、路径和过期设置。

要为域名创建新的 Cookie，请点击“+ New”。

Apidog 支持以下 Cookie 属性：

属性	描述	示例/说明
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

对任意属性进行所需更改

点击 Save 以应用更改

你有多种移除 Cookie 的选项：

操作	如何执行	使用场景
删除单个 Cookie	点击 Cookie 旁边的“Delete”	移除特定的不需要的 Cookie
清除所有 Cookie	在 Cookie 管理器中点击“Clear All”	重新开始或清理测试数据

每当你向已添加 Cookie 的域名发送请求时，该 Cookie 都会自动显示在请求的 Headers 选项卡中。

如果 Cookie 不可见，请选择“hidden”以显示自动生成的头部。

Cookie 头部管理

你不能在 Headers 选项卡中直接覆盖 Cookie 头部。要修改 Cookie，请使用 Cookie 管理器，或删除该 Cookie 并手动设置请求头部。在发送请求之前，Apidog 会合并 Cookie 管理器中添加的 Cookie 和 Headers 选项卡中的 Cookie。

最佳实践

使用描述性名称：让 Cookie 名称清晰且有意义，便于管理

设置合适的过期时间：使用 Expires 或 MaxAge 控制 Cookie 生命周期

保护敏感 Cookie：为身份验证 Cookie 启用 Secure 和 HttpOnly 标志

按域名组织：按各自的域名组织 Cookie，以获得更好的测试工作流

了解 Cookie#

Cookie 组成部分#

Cookie 管理工作流#

使用 Cookie 管理器#

查看 Cookie#

创建 Cookie#

编辑和删除 Cookie#

编辑 Cookie#

删除 Cookie#

随请求发送 Cookie#

最佳实践#

了解 Cookie

Cookie 组成部分

Cookie 管理工作流

使用 Cookie 管理器

查看 Cookie

创建 Cookie

编辑和删除 Cookie

编辑 Cookie

删除 Cookie

随请求发送 Cookie

最佳实践