设置模拟服务器

如果您没有准备好生产 API,或者您还不想针对真实数据运行请求,您可以发出返回 Postman 中定义的模拟数据的请求。通过将模拟服务器添加到您的集合并向您的请求添加示例,您可以模拟真实 API 的行为。

当您向模拟服务器发送请求时,Postman 会将请求配置与您为请求保存的示例匹配,并使用您添加到示例中的数据进行响应。您将在Postman 左侧的Mock Servers中看到工作区中的任何现有模拟。

您需要登录 Postman 帐户才能创建模拟服务器。

模拟服务器

模拟快速启动

要试用模拟服务器,请执行以下步骤:

  • 向 Postman 中的任何 API 发出请求——确保将您的请求保存到集合中。
  • 三个点图标选择右上角的三个点以查看更多操作,然后选择添加示例。Postman 将使用您在发送请求时收到的响应自动填充示例。
  • 在左侧的收藏中,选择收藏并使用右侧的按钮打开信息。选择创建模拟服务器
  • 给你的模拟起个名字,选择默认标签,取消选中延迟选项。选择创建模拟服务器
  • 复制模拟 URL 并返回到您的请求中。将 URL 的基本部分替换为模拟服务器 URL(路径之前的所有内容,例如 up to /customers)。
  • 选择发送。Postman 应该返回您为请求保存的示例响应,这次来自模拟服务器。
  • 再次打开示例并更改模拟响应 JSON,然后将其保存并再次发送请求 - 您将看到您编辑的模拟响应。

内容

创建模拟服务器

您可以从现有集合创建模拟服务器,或者 Postman 将为您的模拟服务器创建一个新集合。您可以从头开始从集合从“新建”按钮从 API从您的历史记录创建新的模拟。

从头开始创建模拟

在Postman 左侧的Mock Servers中,选择+按钮。

新模拟

选择现有集合或添加新集合(添加新集合的初始请求)。

模拟新系列

配置您的模拟详细信息

从集合创建模拟

在 Postman 中打开一个集合,然后从右侧边栏中的按钮打开信息。选择创建模拟服务器

新模拟

配置您的模拟详细信息

从 New 按钮创建一个 mock

选择New并选择Mock Server

新模拟

选择是要模拟现有集合还是为模拟生成新集合(添加请求)。

配置您的模拟详细信息

从 API 创建模拟

如果要从 API 生成模拟集合或将模拟添加到 API 集合:

  1. 从Postman 左侧的API打开一个 API 版本。

  2. 在 API 版本概览选项卡上,在Mock Servers旁边,选择+并选择Create new mock serverAdd existing mock server

    • 创建新的模拟服务器:选择一种方法来建立模拟服务器:

      • 从 API 模式生成:要基于从模式生成的集合创建模拟服务器,请输入集合名称,然后通过选择显示高级设置来配置集合的生成方式。选择Generate Collection and Continue,然后配置mock details
      • 使用现有集合:从下拉列表中选择一个集合。选择Select Collection and Continue,然后配置mock details
      • 创建新集合:输入您的集合将包含的请求。选择Create Collection and Continue,然后配置模拟详细信息
    • 添加现有模拟服务器:在列表中选择现有模拟服务器,然后选择添加模拟服务器

根据历史创建模拟

您可以根据 Postman 历史记录中的请求构建模拟。在左侧的历史记录中,将鼠标悬停在请求或日期上,然后选择三个点图标 > 模拟请求

模拟历史

配置您的模拟详细信息

配置模拟详细信息

当你创建一个模拟服务器时,你会给它一个名字,选择一个发布标签(如果你的集合有一个你想要模拟的特定版本),选择一个可选的环境来运行模拟,并在服务器发送你的之前配置一个延迟模拟响应(选择模拟 2G/3G 网络或以毫秒为单位指定自定义延迟)。

如果您选择将模拟服务器设为私有,则需要在请求标头中添加Postman API 密钥x-api-key:<Your-Postman-API-key>: . 您可以共享该集合,并且您的协作者可以使用他们的 Postman API 密钥来使用该模拟。

并非所有配置选项都可用,具体取决于您用于创建模拟服务器的方法。例如,如果您创建了一个新集合,则不需要选择发布标签,因为新集合没有任何标签。

新模拟

准备好详细信息后,选择Create Mock Server

您还可以选择将模拟 URL 保存到环境变量中,然后您可以通过在发送前激活环境来在请求中引用该环境变量。

Postman 将显示您使用模拟所需的详细信息(您也可以随时从集合中获取这些信息)。

模拟细节

选择Copy Mock URL以开始向您的 mock 发出请求。

您将在右侧的集合概览信息中看到模拟的详细信息。

模拟集合

要编辑或删除模拟,请选择左侧的模拟服务器三个点图标,然后选择模拟名称旁边的。

向 mocks 发出请求

使用您的模拟 URL,您可以立即开始发出请求。确保您要模拟的请求至少添加了一个示例

添加示例

添加的示例

打开一个选项卡(或在现有选项卡中编辑地址)并添加模拟 URL:

https://<mock-id>.mock.pstmn.io/<request-path>

例如:

https://3589dfde-f398-45cd-88eb-b0fa0192fc3f.mock.pstmn.io/matches

模拟 URL 包括模拟的 ID 和带有保存示例的请求的路径。

模拟示例

如果您将模拟 URL 保存到变量中,则可以跨请求引用它——例如,如果您有一个生产服务器和一个模拟服务器,您可以为每个环境提供一个环境,每个环境中的模拟 URL 具有相同的变量名称。通过使用变量的请求,您可以在两个环境之间切换。

您还可以从Postman API检索您的模拟 ID

当您向模拟服务器 URL发送请求时,它将使用相同的路径和方法发回您添加到请求中的示例之一。(您可以提供多个示例,Postman 将返回与您的请求配置最匹配的示例)。

如果您为模拟服务器配置了延迟,Postman 将在发送响应之前等待指定的时间段。

您的 Postman 帐户每月为您提供有限数量的免费模拟服务器调用。检查您的使用限制

使用 HTTP 访问控制进行模拟

除了使用 Postman 应用程序向模拟端点发出请求外,您还可以在浏览器中发出这些请求。

当 Web 浏览器从与其自己不同的域、协议或端口请求资源时,它会发出跨域 HTTP 请求。跨域资源共享 (CORS)是一种标准,它定义了浏览器和服务器可以安全交互的方式,在这种情况下,指的是 Web 浏览器如何与 Postman 服务器上托管的模拟端点交互。

为 Postman 模拟服务器启用了 CORS。因此,您可以使用模拟端点使用模拟数据存根您的 Web 应用程序。然后,开发或生产 Web 应用程序可以向您的 Postman 模拟端点发出请求并接收示例响应。

查看模拟呼叫

您可以使用模拟呼叫日志查看和搜索对模拟服务器的调用的详细信息。从Postman 左侧的Mock Servers打开一个 mock 。您的模拟概览和通话记录将打开。

模拟电话

模拟调用日志列出了对模拟 url 进行的调用的概述,以及您可以深入了解的请求和响应详细信息。

模拟呼叫日志条目指示发送请求的时间、请求方法和路径以及响应概述。选择一个条目以查看有关请求标头和正文或响应标头和正文的更多详细信息。

使用搜索字段查找特定呼叫,使用列表顶部的刷新按钮查看最新请求。

模拟呼叫故障排除

您可以使用模拟呼叫日志对模拟服务器的请求进行故障排除。

模拟呼叫错误

如果您看到ResponseNo matching requests列中列出,这可能意味着您的模拟服务器设置不正确。确保您在已连接模拟的集合中为请求保存了一个示例。

在服务中断的情况下,您将收到 502/503/504 响应。如果您遇到这种情况,请订阅并检查 Postman状态页面以获取更新。

下一步

有关模拟服务器的更多信息,请参阅以下资源: