如何将 swagger 2.0 方案字段迁移到 openApi?
How to migrate swagger 2.0 schemes field into openApi?
在我们旧的 swagger 2.0 定义中,我们有以下行:
"schemes" : [ "http", "https" ]
部署时,我们可以在swaggerUI中看到一个select框,可以让我们选择scheme,这在运行本地的时候还是蛮有用的
现在,我想将我们的 API 转换为 OpenApi。我尝试使用 https://swagger.io/ 的 Swagger 编辑器这样做,它有一个自动转换工具,但是方案行已经消失了。它在 OpenApi 中被弃用了吗?我找不到任何关于使用什么的指南。我应该怎么做才能让本地开发人员选择使用哪种方案,即使是使用 OpenApi 定义?有什么想法吗?
servers
替换了 OpenAPI 2.0
中使用的 host
、basePath
和 schemes
关键字
在这种情况下,您需要定义两个服务器(http 和 https)。
servers:
- url: http://api.example.com/v1
- url: https://api.example.com/v1
可以找到完整的文档 here。
在我们旧的 swagger 2.0 定义中,我们有以下行:
"schemes" : [ "http", "https" ]
部署时,我们可以在swaggerUI中看到一个select框,可以让我们选择scheme,这在运行本地的时候还是蛮有用的
现在,我想将我们的 API 转换为 OpenApi。我尝试使用 https://swagger.io/ 的 Swagger 编辑器这样做,它有一个自动转换工具,但是方案行已经消失了。它在 OpenApi 中被弃用了吗?我找不到任何关于使用什么的指南。我应该怎么做才能让本地开发人员选择使用哪种方案,即使是使用 OpenApi 定义?有什么想法吗?
servers
替换了 OpenAPI 2.0
host
、basePath
和 schemes
关键字
在这种情况下,您需要定义两个服务器(http 和 https)。
servers:
- url: http://api.example.com/v1
- url: https://api.example.com/v1
可以找到完整的文档 here。