swaggerはいいぞ

swaggerのステマスライド。
前半はAPIへの情熱を語っただけ、
スライド18枚目からやっとswaggerの話になります。

ぜひswaggerを触ってみてくださいね。

Transcript

1. # 華麗なるRESTful API 〜Open API Specification〜 Masaya Morimoto Hamee Inc.
3. 自己紹介 ＃name: 森本政也 # age: { :24 => “入社3年目” } ＃hobby: [ 音楽, スノボー, 妄想 ] ＃ error: 工数の見積もりを失敗して炎上した経験あり # info: 大学は経営学/金融を専攻
4. Hameeの紹介
5. Hameeの紹介
6. Hameeの紹介
7. Hameeの紹介
8. アジェンダ ＃ 自己紹介 ＃ WEB APIの大海賊時代 ＃ Swaggerはいいぞ ＃ 終わり
9. 話すこと ＃ 私はWEB APIを宝箱だと思っているという話 ＃ swagger(Open API Specification)の紹介
10. 話さないこと ＃ RESTful APIの説明
11. WEB APIの大海賊時代 ＃ WEB API使ってますか？ # WEB API作ってますか？
12. WEB APIの大海賊時代 引用: https://www.ogis-ri.co.jp/otc/hiroba/technical/WebAPI/part1.html
14. ところで
15. こんな思いを抱いたことはありませんか？ # え 、 何 ? こ の オ レ オ レ 仕 様 ＃ ド キ ュ メ ン ト 読 み づ ら い
16. どうやったらいい感じのAPIを作れるん?
17. どうやったら ドキュメントの保守・運用をうまくやれるん?
19. Open API Specification ＃ The goal of The OpenAPI Specification is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. # 人間も機械も言語に依存せずに使える RESTful APIのインターフェースを定義しようや Json形式で
20. Open API Specification = OpenAPI # OpenAPIの理念を実現させるためのツール群があります # swaggerというFWです
22. Swaggerのできること # json || yaml のフォーマットからAPIドキュメントの生成 # APIを叩いて挙動をテストできるスタブの生成 # クライアントのSDKやサーバー実装の雛形の生成
23. さっそく伏線回収 # Json || yaml で定義されるファイルこそが OpenAPI specificationのいうインターフェース定義です - swagger specification: yaml形式 & Json形式 { “OpenAPI specification” => “Json形式” } # 人間も機械も言語に依存せずに使える RESTful APIのインターフェースを定義しようやってやつ
24. Swaggerのできること # swagger/openAPI spec専用のエディタ # APIの実装コードからswagger/openAPI specを生成
25. Swaggerのできること 引用: http://qiita.com/disc99/items/37228f5d687ad2969aa2
26. Swaggerのできないこと #　コードを全く書かずにAPI・APIドキュメントを作る
27. Swaggerはいいぞ # やってみようswagger 一番手軽なeditorとUIとデモします
32. Swaggerのいいなと思うところ # 記述の形式が決まっているから、なんとなく書いてもRESTfulになる # YAML書きやすい、読みやすい
33. WEB APIに感謝！ # 便利なので触ってみてください！ # API周りは色んなツールがあると思うので、 ぜひ情報交換しましょう！
34. 終わり # ご静聴ありがとうございました # 話掛けても逃げないでいただけると嬉しいです！ Masaya Morimoto Hamee Inc.