如何使用 Postman 模拟服务器

Question

我已关注the guide here to create a postman mock 进行邮递员收藏。模拟似乎创建成功，但我不知道如何使用模拟服务。

我已经获得了模拟的 url，但是如何指定我的请求之一？如果我向https://{{mockid}}.mock.pstmn.io 发出 GET 请求，我会收到以下响应：

{
    "error": {
        "name": "mockRequestNotFoundError",
        "message": "We were unable to find any matching requests for the mock path (i.e. undefined) in your collection."
    }
}

根据same guide mentioned above 的以下网址“运行模拟”https://{{mockId}}.mock.pstmn.io/{{mockPath}} 但究竟是什么mockPath？

在我的收藏中，我有很多文件夹，在其中一个文件夹中，我有一个带有示例响应的请求。如何通过模拟访问此示例响应？提前感谢所有帮助！

Here's the Postman Pro API，除了创建阅读模拟之外并没有提及更多内容。

Answer 1

{{mockPath}} 只是您请求的路径。您应该首先为您的任何请求添加一个示例。

例子：

请求：https://www.google.com/path/to/my/api

添加模拟服务器后，您可以访问您的示例：

https://{{mockId}}.mock.pstmn.io/path/to/my/api

Answer 2

如果您有多个相同查询的示例：

模拟请求接受另一个可选标头x-mock-response-code，它指定您返回的响应应该匹配哪个整数响应代码。例如，500 将仅返回 500 响应。如果未提供此标头，则将返回与任何响应代码最接近的匹配项。

诸如 x-mock-response-name 或 x-mock-response-id 之类的可选标头允许您分别通过名称或已保存示例的 uid 进一步指定所需的确切响应。

Here's 文档了解更多详情。

Answer 3

我遇到了同样的问题，看到一个不相关的错误，但最终我找到了解决方案。不幸的是，我在 Postman 网站上找不到参考资料。但这是我的解决方案：

当您创建一个 Mock 服务器时，您定义了您的第一个请求（如 GET api/v1/about）。因此将创建 Mock 服务器，但即使您获得 API 密钥并将其放入请求的标头（如 x-api-key）中，它仍然会返回错误。这没有意义，但事实证明定义请求是不够的。对我来说，它只是在我为请求添加示例时才开始返回响应。

所以我建议对于您创建的每个请求，也至少创建一个示例。您发送的请求将与您创建的示例匹配，并返回匹配的响应。 您可以定义示例响应的 body、headers 和 HTTP status 代码。。

我没有 Pro Postman 订阅，使用我的免费订阅对我有用。

用于添加示例或选择其中一个进行编辑的菜单：

用于定义示例的 UI（参见正文、标题和状态）：

如何返回请求页面：

这是根据我的示例得到的正确回复：

Answer 4

如果您在示例中的请求是 api.domain.com/api/foo 上的 GET，则 mockPath 是 /api/foo，而您的模拟端点是 GET 对 https://{{mockid}}.mock.pstmn.io/api/foo 的调用。

HTTP request methods 和下图所示的路径名构成一个模拟。

为了便于使用，模拟服务器被设计为在集合之上使用。 examples 中的请求与附加的响应一起使用。文件夹或集合的名称不是路径名的一部分，并且在使用模拟时不会在任何地方考虑。模拟集合意味着模拟集合中的所有示例。一个例子是请求和响应的元组。

如果指定了可选的响应状态代码，您可以获取相同路径的适当响应。这可以使用 x-mock-response-code 标头指定。因此，将x-mock-response-code 传递为404 将返回与路径名匹配的示例，并且响应的状态码为404。

目前，如果存在路径相同但域不同的示例，并且 mock 无法区分它们，它将确定性地返回第一个。