首页 > 解决方案 > 将 OpenAPI 3 与 Node.JS 一起使用

问题描述

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

我注意到 swagger npm 模块已经五年没有更新了。还有其他问题,例如这个问题(如何在 Node.js 中使用 OpenAPI 3.0?),基本上没有答案。

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

有没有人对如何将 OpenAPI 3.* 标准实施到节点中的 swagger 应用程序有一些想法/建议?即使您找到了有关如何手动执行此操作的教程或说明,我也将非常感谢您提供一些指导和建议。

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

新标准(3.* vs 2)的更新更容易阅读、实施和重用,这就是我问这个的原因。再次,任何方向或帮助将不胜感激。

标签: node.jsrestswaggeropenapi

解决方案


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

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

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


推荐阅读