接收响应

Postman 响应查看器可帮助您可视化和验证 API 响应的正确性。API 响应由响应正文、标头和 HTTP 状态代码组成。

内容

响应正文

Postman Body选项卡为您提供了多种工具,可帮助您快速了解响应。您可以在以下四种视图之一中查看正文:PrettyRawPreviewVisualize

在响应中查找项目:要打开搜索栏,请选择结果窗格上的放大镜图标。您还可以将光标放在响应中并选择⌘+FCtrl+F。此选项在响应的预览或可视化视图中不可用。

请注意,如果响应的Content-Type标头表明响应是图像,则 Postman 将自动检测并渲染图像。

漂亮

Pretty 视图格式化 JSON 或 XML 响应,以便更容易查看。Pretty 视图中的链接被突出显示,选择它们可以在 Postman 中加载带有链接 URL 的 GET 请求。

要导航大型响应,请选择行左侧的向下箭头以折叠响应的大部分。

响应漂亮的视图

强制 JSON 格式。为了使 Postman 自动格式化正文,响应必须具有适当的Content-Type标头。如果您收到带有不同Content-Type标头的响应,您可以通过 JSON 强制格式化。在 Postman 标题中,选择齿轮图标设置图标,然后选择Settings。在常规选项卡中,从语言检测下拉列表中选择JSON 。

生的

原始视图是一个带有响应正文的大文本区域。它可以指示您的响应是否被缩小。

响应原始视图

预习

预览视图在沙盒 iframe 中呈现响应。默认情况下,某些 Web 框架会返回 HTML 错误,而 Preview 在这些情况下对调试特别有帮助。

由于 iframe 沙盒限制,JavaScript 和图像在 iframe 中被关闭。对于二进制响应类型,您可以选择“发送和下载”以将响应保存在本地。然后,您可以使用适当的查看器查看它。这使您可以灵活地测试音频文件、PDF、zip 文件或 API 返回的任何其他文件类型。

响应预览视图

可视化

Visualize 视图根据您添加到请求Tests的可视化代码呈现 API 响应中的数据。有关如何添加、使用和调试可视化代码的详细信息,请参阅可视化响应

响应可视化视图

饼干

您可以在Cookies选项卡中查看服务器发送的 cookie。cookie 的条目包括其名称、值、关联的域和路径以及有关 cookie 的其他信息。

要了解有关在 Postman 中使用 cookie 的更多信息,请参阅 使用 cookie

标头

标题在标题选项卡下显示为键值对。将鼠标悬停在信息图标标头名称旁边的信息图标上可查看根据 HTTP 规范的标头描述。

如果您发送 HEAD 请求,Postman 将默认显示Headers选项卡而不是Body选项卡。

测试结果

如果您正在查看的 API 请求有任何测试脚本,则结果将显示在“测试结果”选项卡中。

要了解有关在 Postman 中针对 API 请求运行测试的更多信息,请参阅编写测试

网络信息

当您的 API 返回响应时,Postman 会显示网络信息。将鼠标悬停在地球图标刷新图标上可查看您发送的请求的本地和远程 IP 地址。

当您提出https请求时,地球图标包括一个挂锁。当您将鼠标悬停在该图标上时,网络信息将显示其他信息,包括证书验证详细信息。

将鼠标悬停在地球图标上以查看网络信息

SSL 验证错误

如果您在 Postman 的全局设置中启用了 SSL 验证并且验证失败,则响应区域将显示错误消息。选择错误消息中的链接以关闭全局验证并立即再次运行请求。

如果 SSL 已全局关闭但为您的请求打开,您将看到错误和打开控制台的链接。

验证错误

如果您在错误消息中选择禁用 SSL 验证,如果您想为将来的请求验证证书,则需要将其重新打开。要全局启用它,请选择设置图标Postman 标题中的齿轮图标,然后选择Settings。在常规选项卡中,选择SSL 证书验证切换。

要仅为当前请求启用 SSL 验证,请选择请求中的设置选项卡,然后选择启用 SSL 证书验证切换。

如果您关闭了SSL 验证并且您的请求返回证书验证错误,您将在网络信息弹出窗口中看到详细信息。

证书错误

对于成功返回数据但证书验证失败的请求,控制台将显示警告。

响应代码

Postman 显示 API 返回的响应代码。将鼠标悬停在响应代码上以查看代码的简短描述及其含义。

将鼠标悬停在响应代码上以查看说明

一些 API 响应还包含自定义消息,可以帮助您理解响应代码。例如,如果您收到401 Unauthorized响应,则该消息可能会建议您检查您在请求中使用的令牌。如果返回自定义消息,它们将显示在响应的正文中。

响应时间

Postman 自动计算响应从服务器到达所需的时间(以毫秒为单位)。此信息可用于一些初步的性能测试。将鼠标悬停在响应时间上可查看图表,其中包含有关流程中每个事件所用时间的信息。

将鼠标悬停在响应代码上以查看说明

响应大小

Postman 显示响应的大致大小。将鼠标悬停在响应大小上以查看按正文和标题大小划分的细分。

保存回复

如果请求已保存在集合中,您可以保存该请求的响应。返回响应后,选择Save Response

  • 选择另存为示例以将响应保存为您以后可以访问的示例。
  • 选择保存到文件以将响应保存为 JSON 文件。
将 API 响应保存为示例或文件