HTTP 标头

邮件头包含除邮件内容之外的所有信息：发起方（Authorization）、邮件正文格式（Content-Type）、客户端期望的响应格式（Accept）、缓存时长（Cache-Control）、邮件版本（ETag）以及重试时间（Retry-After）。名称不区分大小写；值均为文本。

工作原理

请求或响应由起始行、每行一个头部、一个空行和请求体组成。中间层读取并添加头部，但不修改请求体——例如，代理添加 Via 标识，负载均衡器添加 X-Forwarded-For 标识，CDN 添加其自身的缓存状态标识。许多看似 API 特性的行为实际上是头部约定。

误解

对响应体进行断言就足够了。一些影响最大的错误仅仅存在于响应头中：例如，201 状态码后缺少 Location 属性、允许 CDN 缓存私有响应的 Cache-Control 属性、JSON 响应体中 Content-Type 为 text/html 等。这些错误都能通过所有响应体断言。

点击这里试试

文档面板中的每个响应都会在正文旁边显示其标头，断言语言会使用标头读取它们。<name> — 尝试 headers.etag 存在于 GET /football/v1/standings.

相关内容

• 内容谈判
• What an ETag is

资料来源

• HTTP semantics — RFC 9110
• HTTP caching — RFC 9111

其他术语

• 内容谈判 — 客户端和服务器通过标头而不是单独的 URL 来约定响应格式。
• ETag — 用于表示形式的不透明版本标识符，用于避免重新发送该表示形式并检测冲突的写入。
• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• API 端点 — 一个 URL 加上一个 HTTP 方法——客户端可以调用的最小 API 单元。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日