はじめに Another works サーバサイドエンジニアの釜地です! みなさんOpenAPI(Swagger)は使用されていますか? 本記事ではOpenAPIを導入するに当たって、合わせて利用して便利だったツールを紹介したいと思います。 そもそもOpenAPI(Swagger)とは? OpenAPI仕様(以下OAS)と言われるREST APIを定義するための標準仕様にもとづいて構築された一連のオープンソースツールです。 REST APIの設計、構築、文書化、および使用に役立つ機能を提供します。 弊社の課題感 現状、フロントとサーバを分業制で開発している上で下記のような課題がありました。 APIの伝達がJiraのドキュメントであり、フォーマットが統一されず作成するたびに若干書き方が変わる API仕様が蓄積されていかない → 開発チームが大きくなったときのために今の内からドキュメントを残し