Initiative」という団体を立ち上げ、そのベースをSwaggerを利用するということで一躍注目を集めるようになりました。Swaggerというものを調べるとツールの話やドキュメントの話が出てきて、何なのこれとなることが必定です。いうことで、WebAPIとは切っても切れない関係のSwaggerの話を簡単にしてみます。APIを記述する為の仕様です。当初から、Swaggerが標準の仕様になることを目指しますよと宣言していて、米国等ではデファクト・スタンダードとなっていました。Initiative」が出来たことにより、実際に標準の仕様になる可能性がかなり高くなったというのが現状です。UIなど数多くのツールがあることです。標準化仕様とツールの関係性はなんなのでしょう?特に調べた訳ではないのですが、Swaggerの仕様を普及を後押しする為に作っていった便利ツールでしょう。利用者視点で考えれば、これらのツールこそがSwaggerです。ブラウザ上で動くJSON/YAMLのエディタリアルタイムで構文チェックサードパーティも含めるともっと沢山ありますが、まずはこれくらい覚えておいたら充分でしょう。UIとEditorでしょう。Spec)で書いておく自動的にドキュメント化してくれます。いわゆるコードからドキュメント生成というやつですね。それだけではなく、そのドキュメントから実際のリクエストが投げられます。仕様書からテストまで出来るという優れものです。投げるパラメータは随時変更できるので、ツールとして便利ですね。幾つか使用例ありますが、SORACOMさんのAPIドキュメントもSwagger使っています。リファレンスを見てください。Swaggerの有用性の一端がすぐに解ります。JSONにしろ、YAMLにしろ人間の手で書くには辛すぎる代物です。構文チェックや、リアルタイムでのドキュメント化など、少しだけ手助けをしてくれます。記述した定義を元に、サーバサイドのコードを出力するような機能もあります。いわゆるIDEに近いものがあります。Sasakiwww.slideshare.net標準化団体の出現でSwaggerはどうなるか?ところで標準化団体の出現でSwaggerはどうなるのでしょうか?標準化はSOAPやWDSLが来た道で必ず失敗するという人もいますが、ちょっと違うような気がします。Swaggerは、SOAPのようにプロトコルではありません。ただのRESTの記述方法の定義です。いうことでレイヤーが違うかなと思います。Swaggerは標準化団体ありきで利用促進されている訳ではありません。デファクト・スタンダードの地位を取った後に、その標準化を支援する団体が出来たという流れです。いうことで、元々使っている人たちは、標準化しようがしまいが利用し続けると思います。言った点は強いのではないでしょうか。(とは言っても、それほど寿命が長いものとは思えませんが。)ちなみに標準化団体が出来たことにより、今後は変化は小さく歩みは遅くなると思います。使いづらいところの改善は望みにくくなりますが、バージョンごとの苦労は少なくなると思うので仕方がないでしょう。Gatewayとの関係いろいろとSwaggerのことを書き散らかしたのですが、個人的には標準化団体の動きには全く興味がありません。Gatewayとの関係性のみです。Gatewayは、2015年7月に鳴物入りで登場したサービスです。サーバレスアーキテクチャなどの重要なキーとなるサービスの1つで、おそらく今後使い倒していくことになります。使ってみたところUIベースで使っていくのはかなり厳しいです。運用を考えると、Swaggerで設定をインポートするという使い方が現実的です。いうことで、使わざるを得ないというのが正直なところです。皆さん、諦めて使いましょう。Swaggerは、ツールの方向性とかはセンスが良いと思うのですが、配布方法とかは絶望的にダメです。その辺り何とかしないのかなぁ。有志が勝手になんとかしろということなのでしょうか。~Rubyの実例から学ぶ。Gatewayを作成する前回Swaggerの紹介をしたので、今回はSwaggerを使ってみます。Vol.89を頂きました。Vol89を頂きました。はてなブログをはじめよう!dkfjさんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。