导航邮递员

Postman 提供了多种视图和控件来管理您的 API 项目。

邮递员应用

Postman UI 包括以下组件:

  • 左侧边栏提供对您的集合API环境模拟服务器监视器和请求历史的访问。
  • 标题允许您创建工作区、访问报告、探索公共 API 网络、在 Postman 中搜索、查看同步状态和通知、移动和邀请协作者到工作区、捕获请求和 cookie,以及访问您的设置、帐户和Postman 计划
  • 中心区域是您构建和处理请求的地方。
  • 底部的状态栏允许您显示/隐藏侧边栏,查找和替换,以及打开左侧的控制台。在右侧,您可以启动Bootcamp、collection runner、trash 和两个窗格视图,以及访问帮助资源。

在右侧面板上,您可以看到用于查看文档、注释、代码和请求信息的图标。

右侧面板图标

要打开“文档”选项卡,请选择您的集合下的请求,然后选择迷你文档图标右侧面板上的“文档”图标。

文档图标

要在另一个选项卡中打开文档,请选择查看完整的集合文档

概述文档

要发布集合的文档,请参阅发布您的文档

要打开“评论”选项卡,请选择您的收藏下的请求和迷你评论图标右侧面板上的“评论”图标。您可以切换到评论模式以对请求的特定部分发表评论,包括参数、标头、正文和测试。

概述 评论

要了解有关评论的更多信息,请参阅评论集合

要打开代码片段选项卡,请选择您的集合下的请求,然后选择代码片段图标右侧面板上的代码图标。有关更多信息,请参阅生成代码片段

代码片段窗格

调整窗格大小和折叠窗格

您可以拖动底部面板来调整 Postman UI 中窗格的大小。

调整窗格大小

您还可以通过折叠窗格来整理工作区。使用左下角的按钮隐藏侧边栏,使用右下角的按钮在单个窗格视图和两个窗格视图之间切换。

总体布局

相关集合图标在 Postman 中选择请求后,您可以在右侧面板上看到相关集合(灯泡)图标。

选择该图标可查看API 网络中与您的请求共享相同基本 URL 的公共集合,并包含 API 文档以帮助您入门。

相关收藏建议

您可以选择任何推荐的集合来查看其内容和文档。您也可以直接 fork 推荐的集合来快速开始您的开发。

您可以通过选择 Postman顶部的Search Postman或使用键盘快捷键来访问通用搜索Command + K

输入您的搜索字符串并更改搜索范围以将搜索结果缩小到所有 Postman、您的个人或团队空间或公共 API 网络。您还可以将搜索范围更改为WorkspacesCollectionsAPIsTeams

更改通用搜索的范围

对于登录用户,工作区的默认搜索范围是团队。在explore上,默认是公共 API 网络。对于已注销的用户,结果仅包括公共资源,不包含私人数据。

如果您在结果列表中找不到您要查找的内容,请选择搜索所有工作区、集合、API 和团队,您可以在一页中找到所有结果。

搜索所有

搜索结果页面的左侧导航列出了范围和实体类型。您可以更改这些选项以进一步过滤您的结果。

通用搜索结果页面

您可以使用右侧的排序方式对结果进行排序,方法是选择最相关(默认)、大多数视图最新

搜索结果排序

根据实体类型,搜索结果包含不同的信息:

  • 对于工作区,搜索结果包含工作区类型、摘要、发布者以及发布时间。
  • 对于集合,搜索结果包含工作区类型、集合是否为分叉、发布者以及发布时间。
  • 对于 API,搜索结果包含 API 的名称和摘要、API 的所有者(个人用户或团队)以及工作区的类型。
  • 对于团队,搜索结果包含团队的名称和摘要。选择团队名称会将您重定向到团队配置文件。

查找和替换

在 Postman 应用程序中,您可以通过选择左下角状态栏中的查找和替换,或输入Command + Shift + FCtrl + Shift + F来搜索当前工作区。

输入您的搜索字符串,并可选择选择要返回的实体,必要时输入替换文本。

查找和替换

Postman 搜索选项卡、集合和变量。您可以直接在搜索结果中选择一个项目来打开一个实体。

查找和替换在 Postman for Web 中不可用。

历史

您可以在左侧的“历史记录”选项卡中访问您提出的请求的历史记录。如果您已登录 Postman 帐户,您的历史记录会在您的设备上同步。

历史请求

选择一个请求以再次打开它。选择+将请求保存到集合中。切换保存响应以保存请求响应,以便您可以查看从历史记录中打开请求时返回的内容。

历史记录还包括执行的收集运行。这些仍然是运行的汇总版本,不会记录为单个请求。保存响应选项不能与来自收集运行器的请求一起使用。

查看更多操作菜单允许您保存、监控、记录或模拟请求。使用删除(垃圾箱图标)或清除所有选项从您的历史记录中删除请求。您可以通过按CommandControl并选择请求来选择多个请求。

标签

选项卡允许您在多个请求之间组织和工作。

打开一个新标签

要打开新选项卡,请选择屏幕中间的+

键盘快捷键:您还可以在键盘上选择Command + TCtrl + T打开一个新选项卡。

打开一个新标签

如果您打开一个请求但不编辑或发送它,然后打开另一个请求,第二个选项卡将替换第一个选项卡。When the tab is in preview mode, it displays in italics.

您可以设置 Postman 是否在新选项卡中打开请求。选择齿轮图标设置图标打开设置。在Requests下,使用Always open requests in a new tab旁边的切换开关来打开或关闭此选项。

管理选项卡

您可以同时打开多个选项卡。要重新排列打开的选项卡,请按所需顺序选择并拖动它们。

要管理您打开的标签或访问最近关闭的标签,请选择三个点三个点图标以打开带有操作选项的菜单:

  • 最近关闭的标签:显示您最近关闭的标签。选择一个以重新打开它。
  • 复制选定选项卡:(仅限桌面应用程序。)复制当前选项卡。这不会创建请求的副本,因此当您复制选项卡时,您所做的任何编辑都会反映在原始请求中。
  • 关闭选定选项卡:关闭当前选项卡。如果选项卡包含未保存的更改,邮递员会在关闭前询问您是否要保存。
  • 强制关闭选定选项卡:关闭当前选项卡而不保存任何更改。
  • 关闭除选定选项卡以外的所有选项卡:关闭所有选项卡,您当前正在使用的选项卡除外。
  • 关闭所有选项卡:关闭所有选项卡。如果任何选项卡包含未保存的更改,邮递员会在关闭前询问您是否要保存。
  • 强制关闭所有选项卡:关闭所有选项卡而不保存任何更改。
使用操作菜单管理选项卡

您还可以通过右键单击现有选项卡来管理打开的选项卡或打开新选项卡:

  • 新请求:(仅适用于 Web 的 Postman。)打开一个新选项卡。
  • 重复选项卡:(仅限桌面应用程序。)复制当前选项卡。这不会创建请求的副本,因此当您复制选项卡时,您所做的任何编辑都会反映在原始请求中。
  • 关闭选项卡:关闭当前选项卡。如果选项卡包含未保存的更改,邮递员会在关闭前询问您是否要保存。
  • 强制关闭选项卡:关闭当前选项卡而不保存任何更改。
  • 关闭所有选项卡:关闭所有选项卡。如果任何选项卡包含未保存的更改,邮递员会在关闭前询问您是否要保存。
  • 强制关闭所有选项卡:关闭所有选项卡而不保存任何更改。
管理标签

关闭未保存的选项卡:您可以设置当您关闭包含更改的选项卡时 Postman 是否询问您是否要保存。选择齿轮图标设置图标打开设置。在Requests下,使用关闭未保存选项卡时始终询问旁边的切换开关来打开或关闭此选项。

如果您打开了很多选项卡,它们可能会溢出选项卡栏的区域。要导航到可视区域之外的选项卡,请选择选项卡栏左侧或右侧的箭头。

滚动浏览选项卡

保存或放弃更改

如果选项卡有未保存的更改,Postman 会在选项卡名称旁边显示一个点。选择保存图标 保存以保存更改。要放弃更改,请选择关闭图标关闭图标以关闭选项卡,然后选择不保存

查看冲突

如果您或协作者在另一个选项卡或工作区中更改它,则该选项卡可能表示冲突。Postman 会提示您解决可能发生的任何冲突。

显示冲突的选项卡

下一步

了解 Postman 的最佳方式是启动右下角的Bootcamp并完成课程。

训练营

要查找更多资源以开始使用 Postman,请选择左上角的主页。

训练营主页

尝试发送您的第一个请求