HTTP 头部提供有关 API 请求的重要元数据,例如内容类型、身份验证凭据和缓存指令。Apidog 让你可以轻松配置请求头部,同时还会根据你的请求配置自动管理常见头部。配置请求头部#
你可以在请求的 Headers 选项卡中设置头部。输入所需的任意键值对,Apidog 会将它们随你的请求一起发送。Apidog 会为常见选项提供提示,帮助你自动补全设置,例如 Content-Type。常见头部#
| 头部 | 用途 | 示例值 |
|---|
| Content-Type | 指定请求主体的媒体类型 | application/json |
| Authorization | 包含身份验证凭据 | Bearer token123 |
| Accept | 指定可接受的响应格式 | application/json |
| User-Agent | 标识客户端应用程序 | Apidog/1.0 |
| Cache-Control | 缓存机制的指令 | no-cache |
自动生成的头部#
Apidog 会根据你的请求选择和设置,自动向请求添加某些头部。点击请求 Headers 选项卡顶部的 Hidden 选项,可以查看 Apidog 将随你的请求发送哪些内容的信息。将鼠标悬停在某个头部上可查看其详细信息。Apidog 会说明添加该头部的原因,以及在需要时如何停用或覆盖该头部值。你可以在 Authorization 选项卡、请求 Body、请求域名的 Cookies、Settings 中更改头部;在某些情况下,也可以直接在 Headers 选项卡中更改。如果需要导航到应用的其他部分,Apidog 会在右侧显示一个链接。覆盖自动生成的头部#
要在 Headers 选项卡中停用自动生成的头部,请清除其复选框。要覆盖自动生成的头部值,请清除自动生成条目旁边的复选框,并为该头部添加一个单独条目,在 Key 字段中填写其名称,在 Value 字段中填写你想要的值。如果同一个头部有多个条目,Apidog 会指明哪一个将被覆盖。Apidog 会优先使用你在 Headers 中显式添加的头部,或通过在请求其他部分(例如 Authorization)中的选择而间接添加的头部。被覆盖的头部将显示为类似 ~~Authorization~~ 的形式。对于 Content-Length 和 Content-Type 头部,Apidog 会在你发送请求时,根据 Body 选项卡中的数据自动计算这些值。不过,如有需要,你也可以覆盖这两个值。