Open API仕様記述ツールを比較してみた - Qiita

はじめに フロントサイドとサーバーサイドのエンジニアが、分業する際に大事なものはなんでしょうか。 コンポーネントの切り方の認識合わせ？？そうかもしれません。 それと同様に大切なのが、API仕様の共有の仕方だと思います。 今回、私たちのチームではサーバサイドのAPIの開発に先立ち、フロントサイドの開発をする箇所が出てきたため、 Open API仕様記述ツールを投入して仕様共有してみることとしました。 そもそもOpen API仕様って Open API仕様（OpenAPI-Specification）とは、一言で言ってしまえばREST APIを記述する為の仕様。yamlやjsonに近い形式で記述することができます。 GitHub - OAI/OpenAPI-Specification: The OpenAPI Specification Repository もともとSwaggerっていうフレ