背景 Web API Advent Calendar 12月3日分@takurosさんの12月2日のSwaggerとは何か? を前提としています。 概要 swagger-docs を使ってRailsのREST APIをswaggerで表示出来るようにします。郵便番号検索APIのAPIを表現してみます。 手順 Gemfileにswagger-docsを追加します。 しかしながら、masterブランチにバグがあり、pathにスラッシュが付かないので、forkされたgemを使います。 gemをインストールします。 $ bundle swaggerの初期設定ファイルを作成します。 initializerをconfig/initializers/swagger_docs.rbに作成して、以下のようにAPIサーバの基本情報を書いておきます。 該当するControllerに、API仕様を追記します。 今
![Railsで作ったREST APIをSwagger対応](https://cdn-ak-scissors.b.st-hatena.com/image/square/ef8c5a6d18b33f81a965fbbe4e8e2c71c2a1e78f/height=288;version=1;width=512/https%3A%2F%2Fblog.teraren.com%2Fwp-content%2Fuploads%2F2015%2F12%2Fscreencapture-localhost-3000-swagger-dist-index-html-1449077955013.png)