响应(response)
在某种程度上说,确保API响应正确是您在使用API时众多需要做的事情中非常重要的一项。Postman的response查看器将使您的这个任务更容易。
API响应由主体body,头部headers和状态码组成。Postman在不同的标签中组织body和headers。状态码与完成API调用所需的时间一起显示在选项卡旁边。您可以将鼠标悬停在状态码(status code)上,以获取有关状态码的更多详细信息。大多数情况下,它将是HTTP规范规定的默认描述,但是API作者也可以添加自定义的描述。
保存响应
如果请求已保存在集合中,则可以保存该请求的响应。一旦返回响应,单击保存响应(Save Response)按钮。输入名称来命名保存的响应。保存在请求中的所有响应将在您加载请求时作为示例example提供。单击右上角的示例 Examples下拉列表以查看并选择保存的示例。
查看响应
Postman的body标签为您提供了几个工具来帮助您快速理解。body可以在三个视图中看到: pretty, raw, 和 preview.。
pretty
pretty模式可以格式化JSON或XML响应,以便更容易查看。没有人想滚动一个最小的单行JSON响应寻找那个难以捉摸的字符串!pretty模式中的链接会突出显示,点击它们可以使用链接URL在Postman中加载GET请求。对于一个比较大的响应,单击左侧的向下三角形(▼)可以折叠响应以便查看。
要使Postman自动格式化body,请确保header返回Content-Type 。如果API不这样做,那么您可以强制使用JSON或XML进行格式化。您可以通过从语言检测(Language detection)
下拉菜单中选择“JSON”,在设置(SETTINGS)
窗口的常规(General)
选项卡下强制使用JSON格式。
在响应中查找项目: 可以使用CMD / CTRL + F 打开搜索栏,然后使用CMD / CTRL + G 滚动查看结果。查看完整的键盘快捷键。
Raw
raw视图只是一个响应体的文本区域。它可以帮助您判断您的响应是否有缩小。
Preview
Preview选项卡会在沙盒iframe中呈现响应。一些Web框架默认情况下返回HTML错误,preview模式在这里特别有用。由于iframe沙盒限制,JavaScript和图像在iframe中被禁用。
如果你打算花费大量的时间来查看响应,您可以最大化响应窗口。
如果您的API返回图像,Postman将自动检测并呈现。对于二进制响应类型,您应该选择“发送和下载”,这将使您将响应保存到硬盘。然后,您可以使用合适的查看器查看它。这使您可以灵活地测试音频文件,PDF,zip文件或API抛出的任何内容。
Headers
Headers在 Headers选项卡下显示为键值对。悬停在header名称上可以根据HTTP规范给出对header的描述。如果您发送HEAD请求,Postman将默认显示headesr选项卡。
响应时间
Postman自动计算响应从服务器到达所花费的时间。这对于一些性能的初步测试是有用的。
响应大小
Postman将响应大小分解为body和headers。响应大小是近似值。
Cookies
服务器发送的Cookie可在专用选项卡中显示。要在Postman中管理本地应用程序的Cookie,请使用管理COOKIES(MANAGE COOKIES)窗口。如果您在Postman Chrome应用程序中工作,可以使用Interceptor扩展来帮助管理Cookie。
测试
除了从请求的服务器获得的所有内容之外,还可以查看针对请求运行的测试的结果。了解更多有关Postman 测试的信息。