Swagger 仕様を複数ファイル出力する goa プラグイン Multiswagger を作った - tchsskのブログ
作りました。 github.com goa とは Go でマイクロサービスな Web API を作るためのライブラリです。 github.com goa の DSL で design と呼ばれる定義を書いたら、 goagen というジェネレータを使ってサーバやクライアントなど各種のコードを生成することができます。日本語だと @ikawaha さんによる連載記事が非常にわかりやすくてオススメです。 ikawaha.hateblo.jp Multiswagger とは Swagger 仕様を出力するための goagen のプラグインです。 goagen に内蔵されているデフォルトの Swagger ジェネレータと互換性がありますが、Description() という DSL が JSON のとき、そのキー毎に Swagger 仕様を出力します。 apidsl.Description(`{ "k
goa tips : swagger-ui を使って手っ取り早く API を試す - 押してダメならふて寝しろ
はじめに 折角 API を作ったら，簡単に試して，仕様も俯瞰的に確認したいものです． そんなわけで，今回は開発環境で使える swagger-ui の tips です． swagger-ui は swagger ドキュメントを閲覧するためのサービスを提供してくれます． しかも API コンソールがついているので，ドキュメントを確認しながらその場で API を試すことが出来ます． github.com これをサービスとして立ち上げて，goa で生成した swagger ドキュメントをセットするというのもまどろっこしいので， goa で生成したサービスを立ち上げると，swagger-ui も一緒にサービスするようにしてしまおう．というのが今回の目標です． swagger-ui を配置 swagger-ui の distフォルダをコピーしてきます． 以下の説明では，作業ディレクトリの swagge
goa の API デザインの書き方 後編 (Resource と Payload) - 押してダメならふて寝しろ
概要 goa の API デザインについて，デザインを定義する4つの要素の概要説明の後半です． ✓ API … API サーバの定義 ✓ MediaType … レスポンスデータの定義 Resource … APIが管理するデータへのアクセス方法 / エンドポイントなどを定義 Payload … API に送信するデータの定義 今回は残りの Resource と Payload の説明です． 準備：API サンプル おなじみの最小構成サンプル．全体の把握のために貼っておきます． package design // The convention consists of naming the design // package "design" import ( . "github.com/goadesign/goa/design" // Use . imports to enable the
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
