Postman コレクションのインポート・エクスポート方法 (2026年版)

Postman Collection のインポートとエクスポート方法 (2026年版)

Postman Collection は、API リクエストを整理、共有、ドキュメント化するための標準的な方法です。チーム内でのエンドポイントの共有、ワークスペース間の移行、作業内容のバックアップ、CI/CD パイプラインの設定など、Collection を効率的にインポートおよびエクスポートする方法を知ることは不可欠です。

このガイドでは、デスクトップアプリ、Postman API、CLI、および一般的なフォーマットを含む、2026年における Postman Collection のインポートとエクスポートのあらゆる方法を網羅します。

Postman Collection とは？

Postman Collection は、API リクエストのグループとその設定を含む JSON ファイルです。

• リクエスト URL、メソッド、ヘッダー、ボディ
• Pre-request script（事前リクエストスクリプト）とテストスクリプト
• 変数と認証設定
• フォルダ構造とドキュメント
• レスポンス例

Collection は .json 形式を使用し、Postman の Collection v2.1 スキーマに従います。

Collection のエクスポート

方法 1: Postman デスクトップアプリからエクスポート

Collection をエクスポートする最も簡単な方法です。

1. Postman を開き、左サイドバーの Collections に移動します。
2. Collection 名の横にある 3 つの点 (...) をクリックします。
3. Export を選択します。
4. フォーマットを選択します：
   • Collection v2.1 (Recommended) -- 現在の標準
   • Collection v2.0 -- 旧フォーマット、広範な互換性
5. Export をクリックし、.json ファイルの保存先を選択します。

方法 2: Postman API を使用してエクスポート

Postman API を使用して、プログラムで Collection をエクスポートします。

# Postman API キーをこちらから取得してください: https://web.postman.co/settings/me/api-keys

# 全ての Collection をリストアップ
curl -s -X GET "https://api.getpostman.com/collections" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" | jq '.collections[] | {name, uid}'

# UID を指定して特定の Collection をエクスポート
curl -s -X GET "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -o my-collection.json

# 全ての Collection をエクスポートする Python スクリプト
import requests
import json
import os

API_KEY = "YOUR_POSTMAN_API_KEY"
HEADERS = {"X-Api-Key": API_KEY}
BASE_URL = "https://api.getpostman.com"

# 全ての Collection を取得
response = requests.get(f"{BASE_URL}/collections", headers=HEADERS)
collections = response.json()["collections"]

# 各 Collection をエクスポート
os.makedirs("postman_backup", exist_ok=True)
for col in collections:
    uid = col["uid"]
    name = col["name"].replace(" ", "_").replace("/", "_")

    detail = requests.get(f"{BASE_URL}/collections/{uid}", headers=HEADERS)

    with open(f"postman_backup/{name}.json", "w") as f:
        json.dump(detail.json(), f, indent=2)

    print(f"Exported: {name}")

方法 3: Postman CLI (Newman) を使用してエクスポート

Newman は Postman のコマンドラインツールです。主に Collection の実行に使用されますが、API と組み合わせてエクスポートワークフローを構築できます。

# Newman のインストール
npm install -g newman

# Collection をエクスポートして実行するワンステップ操作
curl -s "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -o collection.json

# エクスポートした Collection を実行
newman run collection.json --environment env.json

方法 4: パブリックリンク経由で共有

ファイルをエクスポートせずに素早く共有する場合：

1. Collection の横にある 3 つの点をクリックします。
2. Share を選択します。
3. Get public link を選択します。
4. リンクをコピーして共有します。

リンクを知っている全員が Collection を表示およびインポートできます。

Collection のインポート

方法 1: JSON ファイルのインポート

最も一般的なインポート方法です。

1. Postman を開きます。
2. 左上の Import をクリックします（または Ctrl/Cmd + O を押します）。
3. 次のいずれかを選択します：
   • .json ファイルを ドラッグ＆ドロップ
   • Upload files -- ファイルを選択してブラウズ
   • Paste raw text -- JSON コンテンツを直接貼り付け
4. インポート内容のプレビューが表示されます。
5. Import をクリックして確定します。

方法 2: URL からインポート

URL から直接 Collection をインポートします。

1. Postman で Import をクリックします。
2. Link タブを選択します。
3. Collection の JSON ファイルへの URL（GitHub、Gist、または Postman のパブリックリンクなど）を貼り付けます。
4. Continue をクリックし、次に Import をクリックします。

# 動作する URL の例:
https://raw.githubusercontent.com/user/repo/main/collection.json
https://api.getpostman.com/collections/UID?apikey=KEY
https://www.getpostman.com/collections/SHARE_ID

方法 3: cURL からインポート

cURL コマンドから個別のリクエストをインポートできます。

1. Import をクリックします。
2. Raw text を選択します。
3. cURL コマンドを貼り付けます：

curl -X POST "https://api.example.com/users" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer token123" \
  -d '{"name": "John", "email": "john@example.com"}'

4. Postman が自動的にリクエストに変換します。

方法 4: OpenAPI/Swagger からインポート

OpenAPI 仕様から API 全体をインポートします。

1. Import をクリックします。
2. openapi.yaml または swagger.json ファイルをアップロードします。
3. Postman が全てのエンドポイントを含む完全な Collection を生成します。

# または URL からインポート
# Import > Link タブにこの URL を貼り付けます:
https://petstore.swagger.io/v2/swagger.json

Postman は以下をサポートしています：

• OpenAPI 3.0 および 3.1 (YAML および JSON)
• Swagger 2.0
• GraphQL スキーマ
• RAML
• WSDL

方法 5: Postman API を使用してインポート

# API 経由で Collection をインポート
curl -X POST "https://api.getpostman.com/collections" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d @my-collection.json

# Python: Collection のインポート
import requests
import json

API_KEY = "YOUR_POSTMAN_API_KEY"

with open("my-collection.json") as f:
    collection_data = json.load(f)

response = requests.post(
    "https://api.getpostman.com/collections",
    headers={
        "X-Api-Key": API_KEY,
        "Content-Type": "application/json"
    },
    json=collection_data
)

print(response.json())

Environment（環境変数）のエクスポートとインポート

Collection は多くの場合、Environment 変数に依存しています。これらもエクスポートしましょう。

Environment のエクスポート

1. 左サイドバーの Environments をクリックします。
2. Environment の横にある 3 つの点をクリックします。
3. Export を選択します。
4. .json ファイルを保存します。

Environment のインポート

1. Import をクリックします。
2. Environment の JSON ファイルをアップロードします。
3. Postman の Environments に追加されます。

Environment ファイルの形式

{
  "name": "Production",
  "values": [
    {
      "key": "base_url",
      "value": "https://api.example.com",
      "type": "default",
      "enabled": true
    },
    {
      "key": "api_key",
      "value": "sk-your-key-here",
      "type": "secret",
      "enabled": true
    }
  ]
}

警告: エクスポートされた Environment には、機密情報がプレーンテキストで含まれます。共有する前に機密値を削除してください。

サポートされているインポート/エクスポート形式

フォーマット	インポート	エクスポート	備考
Postman Collection v2.1	○	○	推奨フォーマット
Postman Collection v2.0	○	○	旧フォーマット
OpenAPI 3.0/3.1	○	○	業界標準
Swagger 2.0	○	×	レガシーフォーマット
cURL	○	○ (リクエスト毎)	単一リクエストのみ
HAR	○	×	HTTP アーカイブ形式
GraphQL	○	×	スキーマインポート
RAML	○	×	RESTful API モデリング
WSDL	○	×	SOAP API

ベストプラクティス

Collection のバージョン管理

Collection をコードと一緒に Git で管理します。

# プロジェクト構造
my-api/
├── src/
├── tests/
├── postman/
│   ├── collection.json
│   ├── environment.dev.json
│   ├── environment.staging.json
│   └── environment.prod.json
├── package.json
└── README.md

Collection バックアップの自動化

#!/bin/bash
# backup-postman.sh - cron を使用して毎週実行

API_KEY="YOUR_POSTMAN_API_KEY"
BACKUP_DIR="./postman-backups/$(date +%Y-%m-%d)"
mkdir -p "$BACKUP_DIR"

# 全ての Collection UID を取得
COLLECTIONS=$(curl -s "https://api.getpostman.com/collections" \
  -H "X-Api-Key: $API_KEY" | jq -r '.collections[] | .uid')

for UID in $COLLECTIONS; do
  NAME=$(curl -s "https://api.getpostman.com/collections/$UID" \
    -H "X-Api-Key: $API_KEY" | jq -r '.collection.info.name' | tr ' /' '__')

  curl -s "https://api.getpostman.com/collections/$UID" \
    -H "X-Api-Key: $API_KEY" \
    -o "$BACKUP_DIR/${NAME}.json"

  echo "Backed up: $NAME"
done

共有前に機密情報を削除する

# strip-secrets.py - 共有前に機密値を削除
import json
import sys

with open(sys.argv[1]) as f:
    env = json.load(f)

for val in env.get("values", []):
    if val.get("type") == "secret":
        val["value"] = "REPLACE_ME"

with open(sys.argv[1].replace(".json", "-clean.json"), "w") as f:
    json.dump(env, f, indent=2)

トラブルシューティング

問題	解決策
インポートが「invalid format」で失敗する	JSON が有効か確認してください。JSON バリデーターを使用してください。
変数が {{undefined}} と表示される	Collection と一緒に Environment ファイルをインポートしてください。
Collection v2.0 と v2.1 の不整合	v2.1 フォーマットで再エクスポートしてください。
大規模な Collection のインポートが遅い	機能ごとに小さな Collection に分割してください。
共有リンクの期限が切れた	Collection から新しいパブリックリンクを生成してください。
インポート後にスクリプトが実行されない	スクリプトの依存関係が文書化されているか確認してください。

よくある質問 (FAQ)

Postman Collection を他のツールにインポートできますか？ はい。Insomnia、Thunder Client (VS Code)、Bruno などのツールは Postman Collection フォーマットをサポートしています。OpenAPI エクスポートは、事実上すべての API ツールで動作します。

Collection のエクスポートにサイズ制限はありますか？ Postman は厳格なサイズ制限を課していませんが、非常に大きな Collection（100MB以上）はインポートが遅くなる可能性があります。分割を検討してください。

2 つの Collection をマージできますか？ 組み込みのマージ機能はありません。両方を JSON としてエクスポートし、手動またはスクリプトで結合してから再インポートしてください。

エクスポートされた Collection にはテスト結果が含まれますか？ いいえ。エクスポートにはテストスクリプトが含まれますが、過去のテスト結果は含まれません。CI/CD でのテスト実行には Newman を使用してください。

まとめ

利用可能な方法を知っていれば、Postman Collection のエクスポートとインポートは簡単です。チームでのワークフローには、自動化のために Postman API を使用してください。バージョン管理には、JSON としてエクスポートして Git にコミットします。ツール間の互換性については、OpenAPI フォーマットを使用してください。

画像生成、動画作成、またはアバター合成用の AI 搭載 API をテストしている場合は、Hypereal AI を無料でお試しください。35 クレジット提供、クレジットカード不要です。API には、簡単にテストできる Postman 対応の Collection が付属しています。