APIの設計とWeb上への公開までをシュッとできる基盤をdockerで構築したのでシェアします。 SwaggerについてOpenAPIのフォーマットに準拠したAPI仕様を定義できるツールです。 OpenAPIに従って認証部分やリクエスト、レスポンス形式などを具体的に整理できるので、draw.ioなどの描画ツールでは気づかない部分や漏れを防げます。 Swaggerの実態は静的コンテンツなので、GitHub PagesやAWS S3などにポンと置いて公開できます。 取り急ぎSwaggerを試したい場合はdocker Hubにimageがあるので、下記コマンドでささっと利用可能です。 docker pull swaggerapi/swagger-editor docker run -d -p 80:8080 swaggerapi/swagger-editor Swaggerの利用基盤構築取り急ぎ
![Swaggerの利用基盤をdockerで構築しGitHub Pagesで公開する](https://cdn-ak-scissors.b.st-hatena.com/image/square/ea0671dd4492d4610e96f4eacc3bfdf2ea5ddb3e/height=288;version=1;width=512/https%3A%2F%2Fhodalog.s3.ap-northeast-1.amazonaws.com%2Fwp-content%2Fuploads%2F2017%2F11%2F30170458%2Ftool-icach-700x467.png)