将 OpenAPI 3 与 Node.JS 结合使用

Question

我想将 OpenAPI 3 集成到我的 node.js 项目中并利用可用的 Swagger 工具。

我注意到 swagger npm 模块已经五年没有更新了。还有其他问题，例如这个（How to use OpenAPI 3.0 in Node.js?），基本上没有得到解答。

肤浅的网络搜索没有给我带来任何结果。

有人对如何在节点中的 swagger 应用程序中实现 OpenAPI 3.* 标准有一些想法/建议吗？即使您找到了有关如何手动执行此操作的教程或一些描述，我也会非常感谢您提供一些指导和建议。

我尝试简单地将 OpenAPI 3 标准放入编辑器 ( swagger project edit) 中，就像使用在线编辑器一样，但它会出现疯狂的错误。我尝试手动更新 swagger.yaml 文档，这也导致节点应用程序崩溃。

新标准（3.* vs 2）的更新更容易阅读、实施和重用，这就是我问这个问题的原因。再次强调，任何指导或帮助将不胜感激。

Answer 1

Swagger 从 2017 年 3.0 版本开始更名为 OpenAPI。最初创建 Swagger 标准 (Smartbear) 的公司现在使用 Swagger 名称作为自己的工具，而开放标准则使用 OpenAPI。这就是为什么您没有看到很多使用 Swagger 名称的工具。

Node.js 是一种非常流行的语言，因此有大量可用于 OpenAPI 3.0 的工具。以后搜索时使用“OpenAPI”这个词，你会得到更好的结果。

热门网站https://openapi.tools/提供了各种利用 OpenAPI 的热门工具，以及每个工具使用的语言列表。这是一个很好的起点，尽管还有许多其他工具。