如何在 Open API 规范中使用 Postman 变量

Ant*_*ado 5 postman openapi

我们正在为当前的 API 制定开放 API 规范。我们希望将生成的文件与 Postman 集成,以生成集合并能够轻松发出请求,而无需在进行新更改时更新集合。

现在,我正在使用以下内容:

openapi: 3.0.0
info:
  version: '1.0.0'
  title: 'Objects API'
servers:
  - url: '{{HOST}}/api/3/users/{{USER_ID}}'
Run Code Online (Sandbox Code Playgroud)

如果我使用它,那么生成的集合看起来像这样:

在此输入图像描述

所以它可以工作,但问题是,如果我们现在将 OpenAPI 文件与 swagger 集成,所有内容{{...}}都会出现在文档中。

我看到邮递员在集合上生成了一些变量,例如baseUrl:

在此输入图像描述

虽然我真的不知道如何在自动生成的请求中使用该变量(也就是说,请求是使用该变量生成的)。

有什么想法/技巧可以解决这个问题并使我们的收藏品尽可能被他们使用吗?理想情况下,用例是在 Postman 上导入 OpenAPI 文件并开始发出有效请求,替换尽可能少的值。