將 OpenAPI 3 與 Node.JS 一起使用

Question

我想將 OpenAPI 3 集成到我的 node.js 項目中，並利用可用的 Swagger 工具。

我注意到 swagger npm 模塊已經五年沒有更新了。 還有其他問題，例如這個問題（ How to use OpenAPI 3.0 in Node.js? ）基本上沒有答案。

膚淺的 web 搜索沒有給我任何結果。

是否有人對如何在節點中的 swagger 應用程序中實施 OpenAPI 3.* 標准有一些想法/建議？ 即使您找到了有關如何手動執行此操作的教程或說明，我也將非常感謝您提供一些指導和建議。

我試着像在線編輯器一樣簡單地將 OpenAPI 3 標准放入編輯器（ swagger project edit ），但它會因錯誤而瘋狂。 我嘗試手動更新 swagger.yaml 文檔，這也只會導致節點應用程序崩潰。

新標准（3.* vs 2）的更新更容易閱讀、實施和重用，這就是我問這個的原因。 再次，任何方向或幫助將不勝感激。

Answer 1

Swagger 於 2017 年從 3.0 版開始更名為 OpenAPI。最初創建 Swagger 標准（Smartbear）的公司現在使用 Z336FF1E9AA6177EA7A71984FA8C241B9 工具名稱，而 open 標准以 OpenAPI 命名這就是為什么您沒有看到許多使用名稱 Swagger 的工具的原因。

Node.js 是一種非常流行的語言，因此有大量可用於 OpenAPI 3.0 的工具。 以后在搜索時使用“OpenAPI”這個詞，你會得到更好的結果。

熱門網站https://openapi.tools/提供了各種使用 OpenAPI 的流行工具，以及每個工具使用的語言列表。 這是一個很好的起點，盡管還有許多其他工具。