はじめに APIエコノミーが盛り上がっています。例えばTwitterのようにツイートデータを公開したり、Googleのように画像処理や自然言語処理の技術を公開するのにWebAPIが使われています。 他には、障害に強いサービスを作るためにアーキテクチャをモノリシックからマイクロサービスに移行する動きがあり、マイクロサービス間はWebAPIで繋がっています。 現代においてWebAPIは必要不可欠なインターフェースであり、だからこそWebAPIの設計は非常に綿密に行う必要があります。 今回は、Swaggerを利用したWebAPIの設計方法についてまとめました。 目次 1. APIを設計する前にRestful WebAPIの基礎を学ぶ2. 仕様を考える3. 詳細設計をする4. コーディング5. APIを試用するおわりに 1. APIを設計する前にRestful WebAPIの基礎を学ぶ 下記は良書