Slide 1

Slide 1 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp はじめてでも怖くない! Postman を使って、Web API を触ってみよう! 2019/10/23 #7 はじめてのIT勉強会 in 仙台(2019) CData Software Japan Kazuya Sugimoto -Lead Engineer

Slide 2

Slide 2 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 杉本 和也:Kazuya Sugimoto CData Software Japan, LLC Lead Engineer Microsoft MVP for Business Applications (Dynamics CRM/365) 普段は仕事でも趣味でもひたすらWeb APIを触っているWeb API Horic 今まで100種類くらいのサービスのWeb APIを見たり触ったりしてる(たぶん) Blog:Morning Girl http://kageura.hatenadiary.jp/ Twitter:@sugimomoto Facebook:sugimomoto

Slide 3

Slide 3 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp Postman ってご存知ですか? Web API の開発者「提供する側・活用する側」双方にとってよりよい 開発・検証のエクスペリエンスを提供するクライアントアプリケーション

Slide 4

Slide 4 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp Postman って素晴らしい! たくさん機能が提供されているのだけど とにかく API の検証・テスティングがとっても楽にできるのがいい!

Slide 5

Slide 5 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp そして世は Web API 戦国時代 APIs show Faster Growth Rate in 2019 than Previous Years https://www.programmableweb.com/news/apis-show-faster-growth-rate-2019-previous-years/research/2019/07/17 2012年 TwitterがAPIを公開 2012年から7年で 約17,000 API も増加!

Slide 6

Slide 6 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp Web API はもはや必須の技術スキル! でも・・・ REST? なにそれ? やすむの? 認証? OAuth? よくわからん! HTTP リクエスト? Query? URLパラメータ? JSONですら 敷居が高いのに!

Slide 7

Slide 7 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp curl とかもよーわからん

Slide 8

Slide 8 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 今日のゴール はじめて Web API を触ってみようと言う方向け! Web API って聞いたことがあるけれど、 「イマイチ一歩踏み出せない」 「触り始めるためにどうしたらいいのかわからない」 そんな方に Postman というツールをきっかけにして Web API に踏み出してもらう

Slide 9

Slide 9 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp お試し用APIも公開中

Slide 10

Slide 10 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp これさえ押さえておけば怖くない REST APIを触るための7つの要素 Base URI Web APIサービスの エンドポイント・ア ドレスを指定 Resource 操作したいデータは 何かを指定 Method どんな操作(取得・ 作成・削除・更新) を行うのかを指定 Query データをどこまで・ どれを取得したいの かを指定 Header どんな仕様でデータ をやりとりしたいの かを指定 Body どんなデータを登録 や更新したいのかを 指定 Authentication 誰がアクセスするの か、IDやパスワー ド・Tokenを指定

Slide 11

Slide 11 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 基本的にはすべてAPI仕様書に書かれている Base URI Resource Method Header Authentication Query

Slide 12

Slide 12 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp というわけで、Postmanで試してみよう O’Reilly Book List APIから データを 10件 JSONで取得する

Slide 13

Slide 13 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ① Base URI を入力する

Slide 14

Slide 14 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ② 対象のリソースを指定する OReillyBookList

Slide 15

Slide 15 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ③ Methodを決める 今回はデータを取得するので GET

Slide 16

Slide 16 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ④ Params を選択して ⑤ Query を入力する 今回は10件データを取得するので $top / 10 と入力する Queryを入力すると URIに自動的に追加される

Slide 17

Slide 17 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ⑥ Authorization を選択し て ⑦ Basic Auth Type を選択 する ⑧ UsernameとPasswordを 入力する

Slide 18

Slide 18 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ⑨ Headers を選択して ⑩ JSONデータが欲しいので Accept/ application/json を指定する

Slide 19

Slide 19 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp ⑪ Send をクリック ⑫ Web API を通じて JSON データが取得できた!

Slide 20

Slide 20 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp やった Web API からデータが取得できた!

Slide 21

Slide 21 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp でも、プログラミング言語からどうやったらいいの?

Slide 22

Slide 22 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 安心してください Postman には Code Snippets という 素晴らしい機能があります!

Slide 23

Slide 23 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp Code をクリックします

Slide 24

Slide 24 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 各種プログラミング言語を 選択できる!

Slide 25

Slide 25 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp C# で対象のAPIをどんな風にリクエ ストすればいいのかわかる! 例えば C# を選択すると

Slide 26

Slide 26 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 是非素晴らしい Web API ライフを!

Slide 27

Slide 27 text

© 2018 CData Software Japan, LLC | www.cdata.com/jp 本日の資料 http://bit.ly/hazimetepostman