OpenAPI对“傲慢”

Question

使用OpenApi的实际优势是什么？

我是openApi技术的新手，我只是想知道在openApi中有哪些特性比在swagger中有更多的特性。网上文件帮不了我。有人能帮我吗。

Answer 1

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

如果您阅读了傲慢的博客 Swagger，就会将它交给openapi Initiative，以及所有像editor.swagger.io支持OpenAPI这样的工具，以及两者之间的转换。

当他们写的时候

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

(而swagger也是规范前两次迭代的术语)

如果您不受特定版本的限制，我建议openapi，因为理论上社区更大，并且有自从swagger诉2.0.0以来发生了很多事，比如简化和易用。

支持更多的安全方案，增强的参数类型是基于路径、查询、头还是cookie。

此外，在如何定义示例方面也有了改进。我参加了一个项目，我们希望使用openapi而不是昂首阔步，不幸的是，API GW还不支持它.

Answer 2

Swagger2.0很受欢迎，直到OpenAPI 3.0推出了许多改进，领域的整合。有许多支持解析/验证等新规范的可用工具。除了在上面的响应中已经调用的内容之外，我发现在指定“服务器”方面的更改非常重要。

Swagger2.0只允许一个host+basepath组合，唯一的灵活性是http & https方案。如果您有多个API子域，或者在SaaS世界中，您可能有租户的变量，这是没有用的。

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

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

另一种是参数规格的多样性。Swagger2.0对类型参数的支持有限(除了body模式之外，大多数原语除外)，cookie也不受支持。OpenAPI 3.0甚至允许对参数进行模式设置，并将主体分离成一个专用的requestBody字段。cookie现在是发送参数的附加in位置。

简单地说，OpenAPI 3.0现在已经非常详尽地支持了几个用例，并且考虑它可能是有意义的。