タグ

関連タグで絞り込む (2)

タグの絞り込みを解除

jsonとjsonschemeに関するclavierのブックマーク (1)

  • JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog

    3行で言うと herokuが作ってる prmd を使って、JSON SchemaからAPIドキュメントを出力したよ! スキーマ定義から、GoAPI実装コードも出力するツールを作ったらめっちゃ捗るよ! Goのバリデーション用のライブラリも作ったよ! 今回作ったものの概要とサンプルコード 概要 以前から、APIを開発する上で、以下のようなことが課題となっていました。 そもそもドキュメント書くのがつらい それもあって、ドキュメントより先にコードが変わってしまう ドキュメントと実装の状況の違いが把握しづらい また、ロジックがそんなに複雑ではないAPIでは、実装の作業は リクエストデータのバリデーション 出力データの整形 (フィルタリング) の2つの作業が大きな割合を占めます。 APIの定義ファイルからドキュメントと、バリデーションや出力データ整形のコードを自動生成できれば、大幅に効率が上がると思

    JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog
  • 1