committee + prmd でJSON Schemaをいい感じに運用するFiNC Developer Advent Calendar 2016の19日目の記事です。 要約 リクエスト・レスポンス形式のドキュメントはメンテが大変 メンテされていなくても気がつかないため放置され気味 committeeでJSON Schemaに実装が沿っているかを確認可能 prmdでJSON Schemaを楽に書ける＋人が読めるドキュメントが生成できる メンテされていない事が検出できるので続く（はず API作成時のリクエスト・レスポンス形式問題 サーバとクライアントで並行開発しながらAPIを作成する場合、以下のようにリクエスト・レスポンス形式を整えにくいという問題があります。 リクエストの形式が想定と違う 想定外のキーを送ってくる 構造が想定していない構造 レスポンスに知らないキーが含まれている 同じデータなのにエンドポイントによって形式が違う enumの数値だったり、対応する文字
