Postman Collectionのデータをインポート＆エクスポートする方法：3つの手法（2026年版）

Postman Collection データのインポート & エクスポート方法：3つの手法 (2026年版)

Postman コレクションは、API リクエストを整理、ドキュメント化、および共有するための最も一般的な方法の1つです。チーム間でのコレクションの移動、バックアップの作成、新しいワークスペースへの移行、または開発者との API サンプルの共有など、コレクションデータを確実かつ効率的にインポートおよびエクスポートする方法を知ることは不可欠です。

本ガイドでは、Postman アプリの GUI、Postman CLI (Newman)、および Postman API の3つの方法を解説します。それぞれの手法には異なる長所があり、どのような場面でどの方針を採用すべきかについても触れます。

クイック比較

	手法 1: Postman アプリ	手法 2: Newman CLI	手法 3: Postman API
最適な用途	手動共有、単発のエクスポート	CI/CD パイプライン、自動化	プログラムによるアクセス、バックアップ
形式	JSON (v2.1)	JSON (v2.1)	JSON (v2.1)
一括操作	限定的	スクリプトで対応可能	非常に優れている
自動化	不可	可能	可能
ログインの要否	必要	不要 (ローカルファイルの場合)	必要 (API キー)

---

手法 1: Postman アプリ (GUI) を使用する

これは最もシンプルな方法であり、手動での単発的なエクスポートやインポートに適しています。

コレクションのエクスポート

1. Postman を開き、対象のワークスペースに移動します
2. 左サイドバーでコレクションを見つけます
3. コレクション名の横にある3点ドットメニュー (...) をクリックします
4. Export を選択します
5. 形式を選択します：
   • Collection v2.1 (recommended): 現在の標準フォーマット
   • Collection v2.0: 古いツール向けのレガシーフォーマット
6. Export をクリックし、保存先を選択します

エクスポートされたファイルは、以下のような JSON ファイルになります。

{
  "info": {
    "_postman_id": "abc123-def456",
    "name": "My API Collection",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Get Users",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/v1/users",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "users"]
        }
      }
    }
  ]
}

環境 (Environment) のエクスポート

Environment には、API キー、ベース URL、トークンなどの変数が含まれます。これらは別途エクスポートする必要があります。

1. サイドバーの Environments タブをクリックします
2. 環境名の横にある3点ドットメニューをクリックします
3. Export を選択します
4. JSON ファイルを保存します

エクスポートされた Environment は以下のようになります。

{
  "id": "env-123",
  "name": "Production",
  "values": [
    {
      "key": "base_url",
      "value": "https://api.example.com",
      "type": "default",
      "enabled": true
    },
    {
      "key": "api_key",
      "value": "sk_live_abc123",
      "type": "secret",
      "enabled": true
    }
  ]
}

セキュリティの警告: エクスポートされた Environment ファイルには、シークレット値がプレーンテキストで含まれています。機密情報を削除せずにこれらのファイルをバージョン管理システム（Git等）にコミットしないでください。

コレクションのインポート

1. Postman 左上の Import ボタンをクリックします
2. インポート元を選択します：
   • File: コンピュータから JSON ファイルをアップロード
   • Folder: ディレクトリからすべてのコレクションファイルをインポート
   • Link: ホストされているコレクション JSON の URL を貼り付け
   • Raw text: JSON を直接貼り付け
   • Code repository: GitHub、GitLab、または Bitbucket からインポート
3. インポートのプレビューを確認します
4. Import をクリックします

Postman は複数のフォーマットからのインポートをサポートしています。

形式	サポート状況
Postman Collection v2.1	フルサポート
Postman Collection v2.0	フルサポート
OpenAPI 3.x (Swagger)	フルサポート
OpenAPI 2.0 (Swagger)	フルサポート
GraphQL	フルサポート
cURL commands	フルサポート
RAML	一部サポート
HAR	フルサポート
WSDL	一部サポート

URL からのインポート

これはパブリックリンクを介してコレクションを共有する場合に便利です。

1. Import > Link をクリックします
2. URL を貼り付けます（例）：

   https://raw.githubusercontent.com/your-org/api-docs/main/collection.json
   

3. Postman がコレクションを取得し、インポートします

---

手法 2: Newman (CLI) を使用する

Newman は Postman のコマンドライン・コレクションランナーです。CI/CD パイプラインや自動テストに特に有用ですが、コレクションファイルの管理にも適しています。

Newman のインストール

npm install -g newman

ファイルからコレクションを実行する

newman run my-collection.json -e production-environment.json

URL からコレクションを実行する

newman run https://api.example.com/docs/collection.json

実行結果のエクスポート

Newman は、テスト結果を複数のフォーマットでエクスポートできます。

# JSON レポート
newman run collection.json -r json --reporter-json-export results.json

# HTML レポート
npm install -g newman-reporter-html
newman run collection.json -r html --reporter-html-export report.html

# JUnit XML (CI/CD 用)
newman run collection.json -r junit --reporter-junit-export results.xml

CI/CD での Newman の活用

以下は、コレクションをインポートしてテストを実行する GitHub Actions の例です。

# .github/workflows/api-tests.yml
name: API Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Newman
        run: npm install -g newman

      - name: Run API tests
        run: |
          newman run ./postman/collection.json \
            -e ./postman/test-environment.json \
            --reporters cli,junit \
            --reporter-junit-export results.xml

      - name: Upload test results
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: api-test-results
          path: results.xml

フォーマット間の変換

追加のツールを使用して、コレクションを変換することもできます。

# OpenAPI スペックを Postman コレクションに変換
npm install -g openapi-to-postmanv2

# OpenAPI 3.0 スペックを Postman コレクションに変換
openapi2postmanv2 -s openapi.yaml -o collection.json -p

---

手法 3: Postman API を使用する

Postman API を使用すると、すべてのコレクション、環境、ワークスペースにプログラムでアクセスできます。これは自動バックアップや一括操作に最適な方法です。

Postman API キーの取得

1. web.postman.co/settings/me/api-keys にアクセスします
2. Generate API Key をクリックします
3. キーに名前を付けてコピーします

すべてのコレクションをリスト表示する

curl -s "https://api.getpostman.com/collections" \
  -H "X-Api-Key: PMAK-your-postman-api-key" | python3 -m json.tool

レスポンス:

{
  "collections": [
    {
      "id": "abc123-def456",
      "name": "My API Collection",
      "uid": "12345678-abc123-def456"
    },
    {
      "id": "ghi789-jkl012",
      "name": "Payment API",
      "uid": "12345678-ghi789-jkl012"
    }
  ]
}

単一のコレクションをエクスポートする

curl -s "https://api.getpostman.com/collections/COLLECTION_UID" \
  -H "X-Api-Key: PMAK-your-postman-api-key" \
  -o my-collection.json

コレクションをインポート（作成）する

curl -X POST "https://api.getpostman.com/collections" \
  -H "X-Api-Key: PMAK-your-postman-api-key" \
  -H "Content-Type: application/json" \
  -d @collection-file.json

一括エクスポートスクリプト (Python)

すべてのコレクションをバックアップする Python スクリプトの例です。

import requests
import json
import os
from datetime import datetime

POSTMAN_API_KEY = os.environ["POSTMAN_API_KEY"]
BACKUP_DIR = f"postman-backup-{datetime.now().strftime('%Y%m%d')}"
BASE_URL = "https://api.getpostman.com"

headers = {"X-Api-Key": POSTMAN_API_KEY}

os.makedirs(BACKUP_DIR, exist_ok=True)

# すべてのコレクションを取得
response = requests.get(f"{BASE_URL}/collections", headers=headers)
collections = response.json()["collections"]

print(f"{len(collections)} 件のコレクションが見つかりました")

for collection in collections:
    uid = collection["uid"]
    name = collection["name"]

    # 詳細なコレクションデータを取得
    detail = requests.get(f"{BASE_URL}/collections/{uid}", headers=headers)

    # ファイルに保存
    safe_name = name.replace("/", "-").replace(" ", "_")
    filepath = os.path.join(BACKUP_DIR, f"{safe_name}.json")

    with open(filepath, "w") as f:
        json.dump(detail.json(), f, indent=2)

    print(f"エクスポート完了: {name} -> {filepath}")

# 環境もエクスポート
response = requests.get(f"{BASE_URL}/environments", headers=headers)
environments = response.json()["environments"]

for env in environments:
    uid = env["uid"]
    name = env["name"]

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

    safe_name = name.replace("/", "-").replace(" ", "_")
    filepath = os.path.join(BACKUP_DIR, f"env_{safe_name}.json")

    with open(filepath, "w") as f:
        json.dump(detail.json(), f, indent=2)

    print(f"環境をエクスポート完了: {name} -> {filepath}")

print(f"\nバックアップ完了。{len(collections)} 件のコレクションと {len(environments)} 件の環境が {BACKUP_DIR}/ に保存されました。")

自動バックアップのスケジュール化

バックアップスクリプトを cron ジョブや CI/CD スケジュールに追加します。

# 毎日午前 2 時に実行
0 2 * * * cd /path/to/backup && python3 backup_postman.py

---

よくある問題の解決

インポートが "Invalid Format" で失敗する

通常、JSON 構造が期待されるスキーマと一致していないことを意味します。以下を確認してください。

# ファイルが有効な JSON か確認
python3 -m json.tool < collection.json > /dev/null

# スキーマバージョンを確認
python3 -c "
import json
with open('collection.json') as f:
    data = json.load(f)
    if 'info' in data:
        print('Schema:', data['info'].get('schema', 'Not found'))
    elif 'collection' in data:
        print('Schema:', data['collection']['info'].get('schema', 'Not found'))
"

インポート後に変数が解決されない

コレクションと、対応する Environment の両方をインポートしているか確認してください。{{base_url}} のような変数を機能させるには、アクティベートされた環境が必要です。

大規模なコレクションのエクスポートがタイムアウトする

非常に大規模なコレクション（100回以上のリクエストを含むもの）の場合、Postman API がタイムアウトすることがあります。その場合は、エクスポートを分割するか、初回のエクスポートにはアプリの GUI を使用してください。

---

結論

紹介した3つの手法は、それぞれ異なるニーズに対応します。日常的な手動操作には Postman アプリを、CI/CD への統合とテストには Newman CLI を、そして自動バックアップやプログラムによる管理には Postman API を使用してください。多くのチームにとって、日常業務に手法 1 を使い、自動バックアップに手法 3 を組み合わせることが、最もバランスの取れた運用方法となります。

AI を活用したメディア生成などの API を構築・テストしている場合、Hypereal AI は Postman に簡単にインポートできる、ドキュメントの整備された API エンドポイントを提供しています。この API は標準的な REST 規約に従い、X-API-Key 認証を採用しているため、既存の API テストワークフローへの追加もスムーズに行えます。