Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
業務ツールとして使うPostman
Search
Masayoshi Kimoto
April 18, 2024
Programming
0
120
業務ツールとして使うPostman
2024年4月16日に開催された「Postman API Night Fukuoka 2024 Spring」で登壇させていただいた時のスライドです。公開用に一部改修しています。
Masayoshi Kimoto
April 18, 2024
Tweet
Share
Other Decks in Programming
See All in Programming
TypeScriptで使いやすいOpenAPIの書き方
yukimochi_dwango
1
750
Go製Webアプリケーションのエラーとの向き合い方大全、あるいはやっぱりスタックトレース欲しいやん / Kyoto.go #50
utgwkk
6
2k
Timeline エディター拡張入門
yucchiy
0
450
Fragment Composition of GraphQL
quramy
14
1.7k
Open standards for building event-driven applications in the cloud
meteatamel
0
230
RailsConf 2024: Riffing on Rails: sketch your way to better designed code
kaspth
1
210
Next.js App Router
quramy
14
2.3k
TCAとKMPを用いた新規動画配信アプリ 「ABEMA Live」の設計
tomu28
2
140
GoでParserを書く
karupanerura
3
280
mb_trim関数を作りました
youkidearitai
PRO
1
200
CQRS meets modern Java
simas
PRO
2
470
Findy - エンジニア向け会社紹介 / Findy Letter for Engineers
findyinc
2
74k
Featured
See All Featured
From Idea to $5000 a Month in 5 Months
shpigford
377
45k
Building Your Own Lightsaber
phodgson
100
5.7k
Teambox: Starting and Learning
jrom
128
8.4k
Building Applications with DynamoDB
mza
88
5.7k
Large-scale JavaScript Application Architecture
addyosmani
504
110k
Raft: Consensus for Rubyists
vanstee
133
6.3k
jQuery: Nuts, Bolts and Bling
dougneiner
60
7.2k
How to Ace a Technical Interview
jacobian
273
22k
Optimizing for Happiness
mojombo
370
69k
Fantastic passwords and where to find them - at NoRuKo
philnash
39
2.5k
How GitHub Uses GitHub to Build GitHub
holman
468
290k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
245
20k
Transcript
業務ツールとして使うPostman @Postman API Night Fukuoka 2024 Spring(2024/4/16) 木本 政慶(株式会社オルターブース) Copyright
© Alterbooth Inc. All Rights Reserved. 1
Copyright © Alterbooth Inc. All Rights Reserved. 2 木本政慶(きもと まさよし)
1975年生まれ。2児の父。 所属:株式会社オルターブース クラウドソリューション部 主な特徴:与えられた登壇時間を超過しがち。 @msys75 注:エンジニアとして有益な情報はほぼ投稿してません。 コミュニティラジオ天神「泡欲BARラジオ」(第1・3火曜、21時~) レギュラーアシスタント 注:エンジニアとして有益な情報はまったく喋ってません。
Copyright © Alterbooth Inc. All Rights Reserved. 3 Postman、どう使ってますか? APIを手っ取り早く動かすため?
APIを開発するため?
オルターブースはMicrosoftのCSP(クラウドソリューションプロバイダー)パート ナーとして、お客様にMicrosoftの様々な製品・サブスクリプションを提供。 各種サブスクリプションを提供する上で必要な顧客管理、契約管理、注文処理、 顧客テナントの管理サポート、毎月の請求などが主な業務。 これら多岐にわたるパートナー業務をサポートするために、Microsoftから様々 な機能群「Partner Center」が提供されている。 Postmanが業務ツールになったきっかけ Copyright ©
Alterbooth Inc. All Rights Reserved. 4
Microsoftがパートナー向けに提供している パートナー業務を行うための機能群。 Webアプリとしての「Partner Center」と 個々の機能を提供するAPIがある。 パートナーとしての日常業務はWebアプリでほぼ事足りるが、 Webアプリではできない・やりづらい部分がある。 Partner Center is
… Copyright © Alterbooth Inc. All Rights Reserved. 5
Partner Centerは情報を縦に掘っていく構造 Copyright © Alterbooth Inc. All Rights Reserved. 6
パートナー 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション
情報を横方向に見たいこともある Copyright © Alterbooth Inc. All Rights Reserved. 7 パートナー
顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション これをAPIで実現したい。
Postmanを使いはじめたのだが・・・ Copyright © Alterbooth Inc. All Rights Reserved. 認証がめんどい PowerShellでコマンドを打ってアクセストークンを取得しないといけない
コマンド打つの面倒くさい 取得したアクセストークンをPostmanにコピペしないといけない コマンド打つの面倒くさい 年に数回しかやらないから、認証プロセスの手順を忘れちゃう やっぱりコマンド打つの面倒くさい
ところがPostmanでは・・・ Copyright © Alterbooth Inc. All Rights Reserved. 9 認証がめんどい
めんどくない! PostmanのCollectionに認証サポート機能 が備わっており、ボタンポチ~でアクセス トークンを取得してくれる!! GUI最高!! 本番用・検証用など実行環境ごとにEnvironmentを作成して、認証に必要な情報をセットしておくと、 Environmentの切り替えによって、実行したい環境のトークンが簡単に取得できる。
という話をブログに書きました。 Copyright © Alterbooth Inc. All Rights Reserved. 10 「aadojo
ゆうびんやさん」で検索!!
いざこれを実現しようとすると・・・ Copyright © Alterbooth Inc. All Rights Reserved. 11 パートナー
顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション いろんなAPIを連携させて 動かす必要がある。
Copyright © Alterbooth Inc. All Rights Reserved. 12 これは・・・? Flowsというからには、
APIリクエストをフローさせられるのであろう。
取得したデータをCSVっぽく出力するFlow Copyright © Alterbooth Inc. All Rights Reserved. 13 レスポンスをカンマ区切りにフォーマット変換してログに出力。
Consoleに出力されたログをテキストエディタ等にコピペして、あとは好きなように加工。 年に1~2回の作業であればこれで十分。
どんどん複雑化してます。 Copyright © Alterbooth Inc. All Rights Reserved. 14 連携するリクエストの数が増えたり、繰り返し処理や条件分岐が増えてくると、
リクエストの実行タイミングのズレなどで思うようにフローが流れなくなってくるので試行錯誤が必要。 利用するAPIの設計・仕様との相性によって使いづらくなるケースもありそう。 アプリを実装する前に、FlowsでAPIを連携した時の挙動を確認しながら処理の流れをイメージする、 という使い方もあり。
自分でアプリを作りこむほど頻繁には使わないAPIたち。 頻繁に使わないがゆえに、毎回使い方を忘れてしまう。(特に認証) だったら、Postman Flowsを使ってみよう。 という、やや不純な動機から始まりましたが、APIを使う頻度も増えたし、 頻度が増えてくると、やりたいことも増えてくる。 フローをWebhookをトリガーにして実行することもできるし、 Formも「Coming Soon」となっている。 「業務ツール」ではなく「業務アプリ」になるかも?
業務ツールとしてのPostman Copyright © Alterbooth Inc. All Rights Reserved. 15