業務ツールとして使うPostman

2024年4月16日に開催された「Postman API Night Fukuoka 2024 Spring」で登壇させていただいた時のスライドです。公開用に一部改修しています。

Transcript

1. 業務ツールとして使うPostman @Postman API Night Fukuoka 2024 Spring（2024/4/16） 木本 政慶（株式会社オルターブース） Copyright © Alterbooth Inc. All Rights Reserved. 1
2. Copyright © Alterbooth Inc. All Rights Reserved. 2 木本政慶（きもと まさよし） 1975年生まれ。2児の父。 所属：株式会社オルターブース クラウドソリューション部 主な特徴：与えられた登壇時間を超過しがち。 @msys75 注：エンジニアとして有益な情報はほぼ投稿してません。 コミュニティラジオ天神「泡欲BARラジオ」（第1・3火曜、21時～） レギュラーアシスタント 注：エンジニアとして有益な情報はまったく喋ってません。
3. Copyright © Alterbooth Inc. All Rights Reserved. 3 Postman、どう使ってますか？ APIを手っ取り早く動かすため？ APIを開発するため？
4. オルターブースはMicrosoftのCSP（クラウドソリューションプロバイダー）パート ナーとして、お客様にMicrosoftの様々な製品・サブスクリプションを提供。 各種サブスクリプションを提供する上で必要な顧客管理、契約管理、注文処理、 顧客テナントの管理サポート、毎月の請求などが主な業務。 これら多岐にわたるパートナー業務をサポートするために、Microsoftから様々 な機能群「Partner Center」が提供されている。 Postmanが業務ツールになったきっかけ Copyright © Alterbooth Inc. All Rights Reserved. 4
5. Microsoftがパートナー向けに提供している パートナー業務を行うための機能群。 Webアプリとしての「Partner Center」と 個々の機能を提供するAPIがある。 パートナーとしての日常業務はWebアプリでほぼ事足りるが、 Webアプリではできない・やりづらい部分がある。 Partner Center is … Copyright © Alterbooth Inc. All Rights Reserved. 5
6. Partner Centerは情報を縦に掘っていく構造 Copyright © Alterbooth Inc. All Rights Reserved. 6 パートナー 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション
7. 情報を横方向に見たいこともある Copyright © Alterbooth Inc. All Rights Reserved. 7 パートナー 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション これをAPIで実現したい。
8. Postmanを使いはじめたのだが・・・ Copyright © Alterbooth Inc. All Rights Reserved. 認証がめんどい PowerShellでコマンドを打ってアクセストークンを取得しないといけない コマンド打つの面倒くさい 取得したアクセストークンをPostmanにコピペしないといけない コマンド打つの面倒くさい 年に数回しかやらないから、認証プロセスの手順を忘れちゃう やっぱりコマンド打つの面倒くさい
9. ところがPostmanでは・・・ Copyright © Alterbooth Inc. All Rights Reserved. 9 認証がめんどい めんどくない！ PostmanのCollectionに認証サポート機能 が備わっており、ボタンポチ～でアクセス トークンを取得してくれる！！ GUI最高！！ 本番用・検証用など実行環境ごとにEnvironmentを作成して、認証に必要な情報をセットしておくと、 Environmentの切り替えによって、実行したい環境のトークンが簡単に取得できる。
10. という話をブログに書きました。 Copyright © Alterbooth Inc. All Rights Reserved. 10 「aadojo ゆうびんやさん」で検索！！
11. いざこれを実現しようとすると・・・ Copyright © Alterbooth Inc. All Rights Reserved. 11 パートナー 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション 顧客 サブスクリプション サブスクリプション サブスクリプション いろんなAPIを連携させて 動かす必要がある。
12. Copyright © Alterbooth Inc. All Rights Reserved. 12 これは・・・？ Flowsというからには、 APIリクエストをフローさせられるのであろう。
13. 取得したデータをCSVっぽく出力するFlow Copyright © Alterbooth Inc. All Rights Reserved. 13 レスポンスをカンマ区切りにフォーマット変換してログに出力。 Consoleに出力されたログをテキストエディタ等にコピペして、あとは好きなように加工。 年に１～２回の作業であればこれで十分。
14. どんどん複雑化してます。 Copyright © Alterbooth Inc. All Rights Reserved. 14 連携するリクエストの数が増えたり、繰り返し処理や条件分岐が増えてくると、 リクエストの実行タイミングのズレなどで思うようにフローが流れなくなってくるので試行錯誤が必要。 利用するAPIの設計・仕様との相性によって使いづらくなるケースもありそう。 アプリを実装する前に、FlowsでAPIを連携した時の挙動を確認しながら処理の流れをイメージする、 という使い方もあり。
15. 自分でアプリを作りこむほど頻繁には使わないAPIたち。 頻繁に使わないがゆえに、毎回使い方を忘れてしまう。（特に認証） だったら、Postman Flowsを使ってみよう。 という、やや不純な動機から始まりましたが、APIを使う頻度も増えたし、 頻度が増えてくると、やりたいことも増えてくる。 フローをWebhookをトリガーにして実行することもできるし、 Formも「Coming Soon」となっている。 「業務ツール」ではなく「業務アプリ」になるかも？ 業務ツールとしてのPostman Copyright © Alterbooth Inc. All Rights Reserved. 15