Postman コレクションのインポート・エクスポート方法 (2026年版)
Postman コレクション管理のステップバイステップガイド
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
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 をエクスポートする最も簡単な方法です。
- Postman を開き、左サイドバーの Collections に移動します。
- Collection 名の横にある 3 つの点 (...) をクリックします。
- Export を選択します。
- フォーマットを選択します:
- Collection v2.1 (Recommended) -- 現在の標準
- Collection v2.0 -- 旧フォーマット、広範な互換性
- 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: パブリックリンク経由で共有
ファイルをエクスポートせずに素早く共有する場合:
- Collection の横にある 3 つの点をクリックします。
- Share を選択します。
- Get public link を選択します。
- リンクをコピーして共有します。
リンクを知っている全員が Collection を表示およびインポートできます。
Collection のインポート
方法 1: JSON ファイルのインポート
最も一般的なインポート方法です。
- Postman を開きます。
- 左上の Import をクリックします(または Ctrl/Cmd + O を押します)。
- 次のいずれかを選択します:
.jsonファイルを ドラッグ&ドロップ- Upload files -- ファイルを選択してブラウズ
- Paste raw text -- JSON コンテンツを直接貼り付け
- インポート内容のプレビューが表示されます。
- Import をクリックして確定します。
方法 2: URL からインポート
URL から直接 Collection をインポートします。
- Postman で Import をクリックします。
- Link タブを選択します。
- Collection の JSON ファイルへの URL(GitHub、Gist、または Postman のパブリックリンクなど)を貼り付けます。
- 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 コマンドから個別のリクエストをインポートできます。
- Import をクリックします。
- Raw text を選択します。
- 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"}'
- Postman が自動的にリクエストに変換します。
方法 4: OpenAPI/Swagger からインポート
OpenAPI 仕様から API 全体をインポートします。
- Import をクリックします。
openapi.yamlまたはswagger.jsonファイルをアップロードします。- 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 のエクスポート
- 左サイドバーの Environments をクリックします。
- Environment の横にある 3 つの点をクリックします。
- Export を選択します。
.jsonファイルを保存します。
Environment のインポート
- Import をクリックします。
- Environment の JSON ファイルをアップロードします。
- 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 が付属しています。
