---
title: Postman Flows ✖️ Backlog API で可能性を探る
tags: 
author: [Tetsuya Shibao](https://www.docswell.com/user/midnight480)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/4EZ66DZ3E3.jpg?width=480
description: Postman Flows ✖️ Backlog API で可能性を探る by Tetsuya Shibao
published: June 23, 25
canonical: https://www.docswell.com/s/midnight480/59GVNP-2025-06-23-221658
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/4EZ66DZ3E3.jpg)

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

# Page. 2

![Page Image](https://bcdn.docswell.com/page/Y76221ZZEV.jpg)

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

# Page. 3

![Page Image](https://bcdn.docswell.com/page/G75224W974.jpg)

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

# Page. 4

![Page Image](https://bcdn.docswell.com/page/9J244VQ57R.jpg)

会社紹介
会社名 株式会社ヌーラボ(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

# Page. 5

![Page Image](https://bcdn.docswell.com/page/DEYMM3W6EM.jpg)

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

# Page. 6

![Page Image](https://bcdn.docswell.com/page/VJNWWVP1J8.jpg)

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

# Page. 7

![Page Image](https://bcdn.docswell.com/page/YE9XX63Y73.jpg)

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

# Page. 8

![Page Image](https://bcdn.docswell.com/page/GE822ZMKED.jpg)

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

# Page. 9

![Page Image](https://bcdn.docswell.com/page/LEL22D3P7R.jpg)

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

# Page. 10

![Page Image](https://bcdn.docswell.com/page/4JM88PD2JW.jpg)

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

# Page. 11

![Page Image](https://bcdn.docswell.com/page/PJR55145E9.jpg)

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

# Page. 12

![Page Image](https://bcdn.docswell.com/page/PEXKKY2XJX.jpg)

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

# Page. 13

![Page Image](https://bcdn.docswell.com/page/3EK553M9JD.jpg)

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

# Page. 14

![Page Image](https://bcdn.docswell.com/page/L73KKGY975.jpg)

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

# Page. 15

![Page Image](https://bcdn.docswell.com/page/87D33158JG.jpg)

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

# Page. 16

![Page Image](https://bcdn.docswell.com/page/VJP44QGW78.jpg)

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

# Page. 17

![Page Image](https://bcdn.docswell.com/page/2EVXX569JQ.jpg)

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

# Page. 18

![Page Image](https://bcdn.docswell.com/page/57GVV6N47L.jpg)

実装したPostman Flows
18 / 22

# Page. 19

![Page Image](https://bcdn.docswell.com/page/4EQ664QREP.jpg)

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

# Page. 20

![Page Image](https://bcdn.docswell.com/page/KJ444QNQJ1.jpg)

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

# Page. 21

![Page Image](https://bcdn.docswell.com/page/LE144P5LEG.jpg)

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

# Page. 22

![Page Image](https://bcdn.docswell.com/page/GEWXX25Q72.jpg)

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

