跳到主要内容

使用 gRPC Mock

在 API 优先设计生命周期中，你可能正在设计依赖于新 API 端点的新功能，但另一个团队负责实现这些端点，并且尚未完成。你可以使用模拟服务器，而不是被它阻止，它将请求的样本数据返回到 API 的端点，模拟真实 API 的行为。然后你可以使用模拟服务器来测试你的 API，甚至在它被其他团队实现之前。

使用 gRPC 模拟服务器​

在创建 gRPC 模拟服务器之前，你必须有一个 API 定义。这可以是工作空间中的 API、要导入的 protobuf（协议缓冲区）文件，也可以使用 Postman API Builder 创建新的 API。

要创建 gRPC 模拟服务器，请执行以下操作：

  1. 创建一个新的 gRPC 请求。有关详细信息，请参阅 创建新请求。
  2. 选择输入服务器 URL。
  3. 选择选择 Protobuf API。
  4. 通过以下方式之一输入要使用的 protobuf API：
    • Use an API from this workspace - 在当前工作空间中选择一个现有的 protobuf API。
    • 导入 .proto 文件- 从文件添加新的 protobuf API .proto。
    • 创建一个新的 API - 打开 Postman API Builder 并创建一个新的 protobuf API。
  5. 选择 API 后，再次选择输入服务器 URL ，然后选择**使用模拟 URL**。

模拟服务器将自动生成，并准备好使用。请求 URL 将是一个以随机名称开头并以.srv.pstmn.io. 选择方法，然后选择Invoke，你的请求将收到具有随机值的响应。

模拟服务器将根据你的 protobuf API 的更改动态更新。如果在 API Builder 中对 protobuf API 进行了更改，对模拟服务器的请求将自动实现更改。

重用模拟服务器响应​

每次你向模拟服务器发出请求时，都会返回不同的随机数据。但是，如果你正在编写测试，你可能需要每次都获得相同的响应。这可以在每个响应中使用种子元数据。种子是响应元数据中的随机数。如果你在请求中传递种子，则每次都会返回相同的响应。

要传递种子数据，请执行以下操作：

  1. 向模拟服务器发出 gRPC 请求。
  2. 在响应的“元数据”窗格中，找到名为 的键值对的值seed。 gRPC 响应种子
  3. 在请求的元数据seed窗格中，为种子值 设置一个键值对。 gRPC 请求种子
  4. 再次调用请求。

下一步​

gPRC 中的模拟服务器独立于 Postman 中的模拟服务器功能。有关为其他 API 使用模拟服务器的更多信息，请参阅 设置模拟服务器。