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
2024 コーディング研修
ckazu
2
640
RailsConf 2024: Riffing on Rails: sketch your way to better designed code
kaspth
1
210
Let's learn code review
riofujimon
2
640
Effectで作る堅牢でスケーラブルなAPIゲートウェイ / Robust and Scalable API Gateway Built on Effect
yasaichi
7
1.2k
PHPコードの実行モデルを理解する / Understanding-the-PHP-Execution-Model
shin1x1
0
1k
TypeScriptの型とパフォーマンス (TSKaigi 2024)
ypresto
14
4.4k
欠陥を早期に発見するための Software Engineer in Test とその重要性 / What is Software Engineer in Test and How they works
orgachem
PRO
17
2.3k
GitLab CI/CD で C#/WPFアプリケーションのテストとインストーラーのビルド・デプロイを自動化する
hacarus
0
610
Amazon Aurora Serverless v2が意外と高かった話と、AWS Database Migration Serviceの話
satoshi256kbyte
1
110
RustでAWS Lambda functionをいい感じに書く
taiki45
2
150
The grand strategy of Ruby Parser
yui_knk
4
270
Open AI APIを使う前に知っておきたいアカウントTier の話
akki_megane
0
130
Featured
See All Featured
KATA
mclloyd
16
12k
Stop Working from a Prison Cell
hatefulcrawdad
266
19k
Build The Right Thing And Hit Your Dates
maggiecrowley
25
2k
Typedesign – Prime Four
hannesfritz
36
2.1k
Agile that works and the tools we love
rasmusluckow
325
20k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
12
1.1k
How to train your dragon (web standard)
notwaldorf
75
5.2k
Practical Orchestrator
shlominoach
183
9.8k
Web development in the modern age
philhawksworth
203
10k
Design by the Numbers
sachag
274
18k
Mobile First: as difficult as doing things right
swwweet
217
8.6k
Building Applications with DynamoDB
mza
88
5.7k
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