まだAPI定義管理で消耗してるの?〜Swaggerを用いた大規模アプリ時代のAPI定義管理とコードジェネレート〜 for DroidKaigi 2018
背景 最近は変化し続ける要件に対応するために、システムも柔軟であることが求められています。 そのため、部分的に変更やスケールの可能なシステムを構築し、API経由で連携するマイクロサービス的アーキテクチャが増えてきています。 そういった設計の中で問題になっていくのが、従来のモノリシックなアプリケーションではIDEやコンパイラなどで行っていた、機能間のインターフェイスをどう管理するかという部分です。 Swaggerとは? SwaggerとはRESTful APIのドキュメントや、サーバ、クライアントコード、エディタ、またそれらを扱うための仕様などを提供するフレームワークです。 公式サイトでは、The World's Most Popular Framework for APIsと謳っています。 その理由は、マイクロソフト、Google、IBM、SmartBearなどを大手の企業を含む「Open
swagger-uiの3.xが出ました 個人的に大きく変わったなと思うポイントは、以下の二点です。 YAMLの読み込みがサポートされた swaggerのspecの書式はJSONとYAMLの2種類が用意されているのですが、swagger-ui 2.xではJSONしかサポートされていなかったので、YAMLをJSONに変換して読み込ませる必要がありました 見た目がガッツリ変わった deprecatedとかが地味だったのがわかりやすく表現される様になりました ローカルで動かすのが楽になった 以前こんな記事を書きました。 SwaggerでAPIを定義してインタラクティブAPIドキュメントを見る Dockerを使ってswagger.yamlをサクッとみる このときに比べてswagger周辺のツール群も洗練されてきたので、それに合わせてさくっと見る方法の最新版を書きます。 公式Dockerイメージが有る
前回、こちらの記事でNode.jsを使ったSwaggerによるAPI仕様書を見る方法を紹介しました。 しかし、 Node.jsなんて使ったことねーよ このためだけにNode.jsインストールするとか面倒 という人もいるかもしれません。 そこで奥さん、Dockerを使って超カンタンにやる方法を紹介します。 前提 dockerコマンドが使えること docker-composeコマンドが使えること Docker for Mac, Docker for Windows, Docker ToolBox、ご自分の環境にあったものを用意しましょう。 ちなみに筆者の環境はこうです。 newgyu@newgyu-XPS-13-9350:~/Desktop/test$ uname -a Linux newgyu-XPS-13-9350 4.4.0-33-generic #52-Ubuntu SMP Fri J
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く