Swagger!APIの仕様書を書くのにSwaggerをつかってみたところ思った以上に簡単でしたのでご紹介します。当方の検証環境は以下です。Api用のドキュメントツール群だと思っています。以下のような部分に利点を感じています。公式サイトへは以下リンクよりアクセスしてください。https://swagger.io/この記事ではエディターのセットアップ、APIの定義方法を簡単な例を交えて説明します。Swaggerエディターのセットアップオンラインのエディターを使う方法もありますが、この記事ではローカルで実行する方法を紹介します。SwaggerエディターをダウンロードしAPI仕様書を編集できるようにします。以下URLより最新版のソースコードをダウンロードhttps://github.com/swagger-api/swagger-editor/releaseszipを解凍しindex.htmlをブラウザで開くこんな感じの画面が開きましたでしょうか。次に、webAPIの仕様書を実際に書いてみます。例として用いるのは簡単なToDoアプリ用webAPIです。以下のようなAPIの仕様書を作成していきます。Editorにコピペして下さい。"date-time"これで設定完了です。Editor上には画像のように表示されているかと思います。次に設定した項目について軽く解説します。Swaggerの設定項目についてSwaggerにおいて必須項目は以下の3つです。例で使っている任意項目は以下2つです。エントリポイントのベースパスを指定します。今回は紹介しませんが、任意項目の設定によってエントリポイントのグループ化、スキーマの定義と使い回し、認証方法の指定等も表現することも可能です。APIで一通り設定してあるので、設定する際はそちらが参考になります。