如何将 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

中使用的 hostbasePathschemes 关键字

在这种情况下,您需要定义两个服务器(http 和 https)。

servers:
  - url: http://api.example.com/v1
  - url: https://api.example.com/v1

可以找到完整的文档 here