Spring boot OpenAPI与招摇

与招摇过市相比，使用OpenApi的实际优势是什么

---

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

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

如果您阅读了《大摇大摆》一书，那么它就被交给了OpenAPI倡议，所有的大摇大摆工具（如editor.Swagger.io）都支持OpenAPI，以及两者之间的转换

当他们写的时候

OpenAPI=规范
Swagger=用于实施规范的工具

（而招摇过市也是规范前两次迭代的术语）

如果您不受特定版本的限制，我建议您使用openapi，因为从理论上讲，社区规模更大，而且存在简化和易用性等问题

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

---

此外，在如何定义示例方面也有改进。我参加了一个项目，我们希望使用openapi而不是Swigger来解决这个问题，不幸的是，API GW还不支持它…

Swigger 2.0非常流行，直到openapi 3.0进行了大量改进，整合了各个领域。有许多工具支持新规范的解析/验证等。 除了上面的响应中已经调用的内容之外，我发现指定“服务器”的更改非常重要

Swagger 2.0只允许一个主机+基本路径组合，唯一的灵活性是 http&https方案。在API主机可能有多个子域的情况下，或者在SaaS world的情况下，租户可能有变量的情况下，这是没有用的

"host": "petstore.swagger.io",
"basePath": "/v1",
"schemes": [
  "http",
  "https"
]

OpenAPI3.0通过添加多个服务器URL以及URL中占位符的变量定义来满足这一要求。 它领先了一步，在路径甚至操作级别定义了服务器

另一个是参数规格的多样性。Swagger 2.0对与类型相关的参数的支持有限（除了body schema外，大部分是原语），不支持cookie。OpenAPI3.0甚至允许对参数使用模式，并将主体分隔为专用的requestBody字段。

cookie

是现在发送参数的附加

简而言之，OpenAPI 3现在非常详尽，可以支持几个用例，并且考虑它可能是有意义的。
 OpenAPI是一个。Swagger是SmartBear根据OpenAPI规范构建的工具集的名称。有（而不仅仅是招摇过市的）支持OpenAPI的。