ドキュメントを作ることができます。実行可能な状態で公開されています。仕様が確認できるだけでなく、実際にパラメータを指定した上で実行したり、実行した時のデータのやりとりやその結果までを確認することができて便利です。作成した時にセットで作っておくと、開発後の運用時や機能追加、引き継ぎといった段階においても非常に役立つインタラクティブドキュメントだと思っています。swagger.json)というファイルを用意することで自動作成が可能になります。自動的に作成され、指定した通りに実行が可能になります(そして実際に実行された結果を確認することもできるようになります)。記述方法そのものについては本ブログエントリの範囲ではないので、興味ある方は別途調べていただきたいのですが、そこまで難しい内容ではないと感じています。変換されて指定可能になる、といった具合です:で、ここからが本エントリの本題です。記述する場合のパラメータ指定方法が特殊でちとわかりにくいものでした。試行錯誤した上で実際に動く例を見つけたので、自分の備忘録も兼ねて以下に紹介します。/file)と仮定します。ドキュメント的には特別な部分ではないので)いったん無視します。ドキュメントとして用意する場合の(パラメータ部分の)記述方法をどのようにするか、というのが今回のテーマでした。:特殊な部分を解説します。指定することで実現します。