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コードの漸進的改善 / Progressive Improvement of TypeScript Code
medley
1
440
AmperとFleetを使ったAndroidアプリ
yoppie
0
300
slow types ってなんだろう?
karad
0
210
AppRouter Panel Talk
yosuke_furukawa
PRO
1
520
Using "modern" Ruby to build a better, faster Homebrew
mikemcquaid
2
280
酒飲んでたらテックリードになった話
spbaya0141
0
210
欠陥を早期に発見するための Software Engineer in Test とその重要性 / What is Software Engineer in Test and How they works
orgachem
PRO
17
2.4k
ペパボOpenTelemetry革命
pyama86
2
1.1k
Findy - エンジニア向け会社紹介 / Findy Letter for Engineers
findyinc
2
74k
地方こそサーバーレス、その意義に迫るサーバーレスPHP / Serverless PHP: The Rural Areas, and Why Serverless PHP Matters
seike460
PRO
2
110
Effectで作る堅牢でスケーラブルなAPIゲートウェイ / Robust and Scalable API Gateway Built on Effect
yasaichi
7
1.2k
Namespace, What and Why
tagomoris
3
700
Featured
See All Featured
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
155
14k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
226
51k
Making Projects Easy
brettharned
109
5.5k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
21
2k
Become a Pro
speakerdeck
PRO
13
4.6k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
245
20k
BBQ
matthewcrist
80
8.8k
Designing on Purpose - Digital PM Summit 2013
jponch
111
6.5k
Unsuck your backbone
ammeep
664
57k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
20
1.8k
Code Reviewing Like a Champion
maltzj
515
39k
Build The Right Thing And Hit Your Dates
maggiecrowley
25
2k
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