Postman Flows ✖️ Backlog API で可能性を探る

Postman API Night Fukuoka 2025 Summer Postman Flows × Backlog API で可能性を探る 2025-06-23 Postman API Night Fukuoka 2025 Summer Tetsuya Shibao 1 / 22

目次 - 自己紹介 - 会社紹介 - CREの業務内容 - Backlog APIについて - APIの基本振り返り - Backlogで複数のAPIを組み合わせが必要がある例 - Postman Flowsで実現できるか検討してみる - 実装できるか検討してみた - Postman Flowsで実装する前に各APIの実装 - 環境変数で再利用可能かつ安全に共有 - 実際に実装したPostman Flows - まとめ - さいごに 2 / 22

自己紹介 株式会社ヌーラボ Reliability Engineering部 Customer Reliability Engineering課 ・佐賀市在住 ・大分市出身 ・認定されているもの： ○ AWS Community Builders(Security) ○ 佐賀市公認観光アンバサダー ・佐賀県内のITコミュニティ盛り上げ隊 ○ JAWS-UG佐賀 運営 ■ 今年度ロマンシング佐賀乗っかリイベントやるよ 3 / 22

会社紹介 会社名 株式会社ヌーラボ(Nulab Inc.) 設立 2004年3月29日 代表者 橋本 正徳 事業内容 コラボレーション促進サービスの開発・提供(Backlog/Cacoo/ Typetalk※2025年12月終了/Nulab Pass) 所在地 福岡本社:福岡市中央区大名1-8-6 HCC BLD. 東京:千代田区神田三崎町3-6-14 KAYA水道橋 7F 京都:下京区突抜2-360 いぐちビル 海外子会社 Nulab USA, Inc. (NY) /Nulab Netherlands B.V. (AMS) 4 / 22

提供サービス ・Backlog:プロジェクト管理ツール ・Nulab Pass:Nulab製品向けのアカウント管理・SSO・監査ログ機能が必要な管理者向け ツール ・Cacoo:リアルタイム共同編集作図・図表作成ツール 5 / 22

CREの業務内容 カスタマーサポートとの協力 ・お問い合わせ対応 ○ Backlog / Nulab Pass/ Cacoo ■ 各サービスの使い方 ■ エンタープライズ(オンプレミス環境) ・有料オプション対応 ○ セキュリティチェックシート記入代行 ○ スペースデータバックアップ ○ スペースキー変更 ○ Subversion移行 ・社内業務改善 6 / 22

CREの業務内容 カスタマーサポートとの協力 ・お問い合わせ対応 ○ Backlog / Nulab Pass/ Cacoo ■ 各サービスの使い方 ■ エンタープライズ(オンプレミス環境) ・有料オプション対応 ○ セキュリティチェックシート記入代行 ○ スペースデータバックアップ ○ スペースキー変更 ○ Subversion移行 ・社内業務改善 7 / 22

Backlog APIについて 特徴 ・Webブラウザで出来ることの多くをAPIで実行可能 APIドキュメント ・認証方式:API Key / OAuth 2.0 ・多言語対応:Java, Python, Javascript, Go ・レート制限あり 8 / 22

APIの基本振り返り(質問) ・課題の追加(POST /api/v2/issues) ・Content-Type: application/x-www-form- urlencoded ・JSON形式のデータをパラメータに設定した場合... 【クイズ】次のうち正しいものはどれ? ・A: 全ての項目で登録可能 ・B: 一部の項目を欠損して登録可能 ・C: フォーマットエラーで登録不可 9 / 22

APIの基本振り返り(回答) ・課題の追加(POST /api/v2/issues) ・Content-Type: application/x-www-form- urlencoded ・JSON形式のデータをパラメータに設定した場合... 【クイズ】次のうち正しいものはどれ? ・A: 全ての項目で登録可能 ・B: 一部の項目を欠損して登録可能 ・C: フォーマットエラーで登録不可 10 / 22

正しいAPIのパラメータ設定(Postmanで試してみましょう) ・Backlog APIの課題追加(POST /api/v2/issues) ・Content-Type: application/x-www-form-urlencoded --data "projectId=608169" \ --data "summary=Postman Test" \ --data "description=This is a added issue by postman." \ --data "issueTypeId=3349123" \ --data "priorityId=3" \ --data "customField_480758=Custom Field" 11 / 22

Backlogで複数のAPIを組み合わせが必要がある例 主なユースケース 1. 課題の一括削除 ・課題一覧を抽出し、パラメータで渡して削除 2. 共有ファイルの一覧 ・共有フォルダ内のファイルを検索し、ファイル種別を判定して保存・ダウンロード 3. 課題の添付ファイル操作 ・追加:ファイル送信でID取得 → 課題更新でID指定 ・ダウンロード:添付ファイル一覧 → IDでダウンロード 12 / 22

Postman Flowsで実現できるか検討してみる Postman Flowsの特徴 ・APIをビジュアルに組み合わせて、ワークフロー・統合・自動化 ・APIのビルディングブロックで複雑なソリューションを構築 ○ 条件分岐が可能 ○ list-base loopで繰り返し処理 13 / 22

実装できるか検討してみた 課題の一括削除 ・コレクションに定義したAPIを使って課題一覧を全量取得し、テキストのみで削除できる 共有ファイルの一覧 ・Evaluateブロックを使ってフォルダのシフトは実現できる ・ディレクトリ構成が不明な場合、ルートから再帰的に取得、ループ回数の指定が難しい 課題の添付ファイル操作 ・Postman Flowsにファイル操作ブロックが存在しない ・代替案:Googleドライブ・Box等をPostmanで拾ってトリガーにする ・代替案を使うとなると、Backlog標準機能に外部ストレージ連携がある...😢 14 / 22

実装できるか検討してみた 課題の一括削除 ・コレクションに定義したAPIを使って課題一覧を全量取得し、テキストのみで削除できる 共有ファイルの一覧 ・Evaluateブロックを使ってフォルダのシフトは実現できる ・ディレクトリ構成が不明な場合、ルートから再帰的に取得、ループ回数の指定が難しい 課題の添付ファイル操作 ・Postman Flowsにファイル操作ブロックが存在しない ・代替案:Googleドライブ・Box等をPostmanで拾ってトリガーにする ・代替案を使うとなると、Backlog標準機能に外部ストレージ連携がある...😢 15 / 22

Postman Flowsで実装する前に各APIの実装 必要なAPI実装 1. レート制限(Flows内では使用しない) 1. 各APIを実行した際に、Status 429が返ってくることを条件分岐することで代用可能 2. 課題の一覧取得 1. Backlogのホスト名(https://xxx.backlog.com) 2. プロジェクトキー 3. APIキー 3. 課題の削除 1. Backlogのホスト名(https://xxx.backlog.com) 2. 課題のID(課題の一覧取得で確認ができるID) 3. APIキー 16 / 22

環境変数で再利用可能かつ安全に共有 環境変数の活用 ・固定部分の管理 ○ Backlogのホスト名(https://xxx.backlog.com) ○ APIキー ・セキュリティ対策 ○ APIキーはシークレットとして管理 ○ ワークスペース共有時の非表示設定 17 / 22

実装したPostman Flows 18 / 22

実装したPostman Flows 実装内容 1. コレクションの定義 ○ 課題の一覧取得 ○ 課題の削除 2. Postman Flowsでの実行 3. シナリオによるパラメータ固定 19 / 22

実装したPostman Flowsの問題点 問題点 1. 課題の親子関係を無視 1. Backlogでは親子関係がある場合、子課題から削除する必要がある 20 / 21

まとめ Postman Flowsの利点 ・API操作の自動化が可能 ・条件分岐とループ処理で柔軟な実装 ・環境変数と共有機能でチーム活用が容易 Postman Flowsの良かったところ ・変数オブジェクトが繋がりを可視化できる Postman Flowsへの要望 ・オブジェクト間の繋がりで実践が重ならないように調整したい 21 / 22

Thanks for your time! :) https://speakerdeck.com/midnight480 https://www.docswell.com/user/midnight480 2025-06-23 Postman API Night Fukuoka 2025 Summer 採用ページが新しくなりましたのでぜひ見てみてください https://careers.nulab.com/ 22 / 22