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
97
業務ツールとして使う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
CREってこういうこと? 体験入社 - 提案資料 - / what-is-cre-trial-employment
shinden
0
160
Hanami and htmx
bkuhlmann
0
210
はてなにおける CSS Modules、及び CSS Modules に足りないもの / CSS Modules in Hatena, and CSS Modules missing parts
mizdra
7
960
Azure OpenAI Serviceのプロンプトエンジニアリング入門
tomokusaba
3
840
Apache Hive 4 on Treasure Data
ryukobayashi
0
400
Try creating your own orderedmap
kazamori
1
150
DMMプラットフォームがTiDB Cloudを採用した背景
pospome
9
4.2k
Sheets API使ってみた
toshi0383
2
150
MetricKitで予期せぬ終了を検知する話 / Detect unexpected termination with MetricKit
nekowen
1
190
"config" ってなんだ? / What is "config"?
okashoi
0
250
OpenAPIを中心に考えるAPI開発入門 / Introduction to API Development with a Focus on OpenAPI
seike460
PRO
2
170
VS Code をプロダクトにどう取り込むか
onomax
1
610
Featured
See All Featured
GraphQLの誤解/rethinking-graphql
sonatard
55
9.3k
4 Signs Your Business is Dying
shpigford
176
21k
Keith and Marios Guide to Fast Websites
keithpitt
408
22k
How GitHub (no longer) Works
holman
305
140k
Into the Great Unknown - MozCon
thekraken
14
1k
The Language of Interfaces
destraynor
151
23k
Unsuck your backbone
ammeep
663
57k
Teambox: Starting and Learning
jrom
128
8.4k
Building Flexible Design Systems
yeseniaperezcruz
320
37k
From Idea to $5000 a Month in 5 Months
shpigford
378
45k
Practical Orchestrator
shlominoach
183
9.7k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
6
1.3k
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