3行で言うと herokuが作ってる prmd を使って、JSON SchemaからAPIドキュメントを出力したよ! スキーマ定義から、GoのAPI実装コードも出力するツールを作ったらめっちゃ捗るよ! Goのバリデーション用のライブラリも作ったよ! 今回作ったものの概要とサンプルコード 概要 以前から、APIを開発する上で、以下のようなことが課題となっていました。 そもそもドキュメント書くのがつらい それもあって、ドキュメントより先にコードが変わってしまう ドキュメントと実装の状況の違いが把握しづらい また、ロジックがそんなに複雑ではないAPIでは、実装の作業は リクエストデータのバリデーション 出力データの整形 (フィルタリング) の2つの作業が大きな割合を占めます。 APIの定義ファイルからドキュメントと、バリデーションや出力データ整形のコードを自動生成できれば、大幅に効率が上がると思
![JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog](https://cdn-ak-scissors.b.st-hatena.com/image/square/75dff22d9862cbd30ab7c3fb51647d879ffbfcdd/height=288;version=1;width=512/http%3A%2F%2Fblog.wacul.co.jp%2Fimages%2Fcommon%2Fogp.png)