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
Introducing Kotlin Multiplatform in an existing mobile app - Workshop Edition | AndroidMakers Paris
prof18
0
170
Documentation testsの恩恵 / Documentation testing benefits
ssssota
1
550
スタックトレース始めてみた
kuro_kurorrr
4
1.1k
Direct Style Effect Systems The Print[A] ExampleA Comprehension Aid
philipschwarz
PRO
0
410
Escolhendo (ou não) o melhor ORM para o seu projeto
andreiacsilva
1
160
GitHub Actionsの痒いところを埋めるサードパーティーランナー
dora1998
1
240
Let's learn code review
riofujimon
2
640
The Cutting Edge Of Versioning (LambdaConf 2024)
chriskrycho
0
250
TypeScriptコードの漸進的改善 / Progressive Improvement of TypeScript Code
medley
1
420
最近コードレビューで指摘したこと
forrep
3
110
How to improve maintainability and readability of your automated tests? ( #scrumniigata )
teyamagu
PRO
1
130
CDKコントリビュートの最初の壁を越えよう! -簡単issueの見つけ方-
badmintoncryer
3
420
Featured
See All Featured
Automating Front-end Workflow
addyosmani
1357
200k
What the flash - Photography Introduction
edds
64
11k
No one is an island. Learnings from fostering a developers community.
thoeni
16
2.1k
Pencils Down: Stop Designing & Start Developing
hursman
117
11k
Build your cross-platform service in a week with App Engine
jlugia
226
17k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
82
45k
What's new in Ruby 2.0
geeforr
338
31k
Designing for Performance
lara
601
67k
Git: the NoSQL Database
bkeepers
PRO
423
63k
The Illustrated Children's Guide to Kubernetes
chrisshort
32
47k
Why You Should Never Use an ORM
jnunemaker
PRO
51
8.7k
Building Effective Engineering Teams - LeadDev
addyosmani
33
1.9k
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