API仕様書を作成する際に、openapiで書くかswaggerで書くか

Question

質問

API仕様書をswaggerもしくはopenapiで記述し、管理していきたいと思っています。

それぞれ、文法が微妙に異なるようなんですが、流行り廃れを含め、swaggerとopenapiのどちらを選んだらいいでしょうか？

Answer 1

openAPIとswaggerが名前が違うだけのバージョン違いというのは分かってますか？
今から使うならopenAPI（v3）以外の選択をする理由がありません。
公式ドキュメントも十分です。
英語だらけの公式マニュアル見ながら書くのが嫌でそこら辺のネット記事を参考にして書きたいのならswaggerの方がまだ検索結果が若干多い感じがするのでswagger使ってもいいかもしれませんが、そんな理由でswaggerを選ぶのは非推奨です。

それとタグがflaskとexpressついてますが、使う言語は絞れてますか？絞れているならopenapiを生成してくれるライブラリを探してみましょう。nodejsは知りませんが、多分あるんじゃないかなと。