OpenAPI 与 swagger

Question

与 swagger 相比，使用 OpenApi 的实际优势是什么？

我是 openApi 技术的新手，只是想知道 openApi 中比 swagger 中更多的功能。在线文档对我没有帮助。谁能帮我。

Answer 1

OpenApi 本质上是 swagger 的进一步开发，因此版本为 3.0.0 而不是 1.0.0

如果您阅读了swagger 博客， Swagger 已移交给 OpenAPI Initiative，并且所有 swagger 工具（例如 editor.swagger.io）都支持 openapi，以及两者之间的转换。

正如他们所写

OpenAPI = 规范
Swagger = 实现规范的工具

（swagger 也是规范前两次迭代的术语）

如果不受特定版本的限制，我会推荐 openapi，因为理论上社区更大，而且自 swagger v. 2.0.0 以来发生了很多事情，例如简化和易用性。

支持更多安全方案，根据参数类型是否在路径、查询、标头或 cookie 中进行增强。

定义示例的方式也得到了改进。我参与了一个项目，我们希望使用 openapi 而不是 swagger 来解决这个问题，不幸的是，API GW 还不支持它......