Postman Collection
Collection 解析 · リクエスト抽出
Postman
準備完了
ABOUT
Postman Collection について
Postman Collection JSON をインポートし、コレクション内のリクエストメソッドと URL 構造を素早く閲覧できます。
Postman Collection はチーム API 資産の中核ですが、JSON ボリュームが大きく階層も深く、直接読むのは困難です。構造化サマリーで数分以内に Collection 全体を把握し、ドキュメント作成と移行評価の時間を節約できます。
DEEP DIVE
Postman Collection を詳しく
Postman は API 開発で最も人気のある協業ツールの一つ。Collection は JSON 形式でエクスポートされ、様々なツールで消費できます。JSONSort Postman パーサーは Collection 内のリクエスト一覧、HTTP メソッド、URL、header 構造を抽出し、Postman クライアントで1つずつ開かなくても素早く閲覧できます。
チーム API ドキュメント作成、Collection 移行評価、Postman エクスポート後の他形式（OpenAPI 中間ステップなど）変換に最適。すべてローカル解析、Collection 内の環境変数名と URL はアップロードされません。
Collection v2.1 には item、request、response、auth など豊富なメタデータが含まれます。パーサーは request メソッドと URL など主要フィールドに焦点を当て、API リスト生成に便利。完全なオリジナル JSON はフォーマットツールで詳細確認できます。
FEATURES
主な機能
Collection 解析
Postman Collection v2 JSON 形式を解析します。
リクエスト一覧抽出
すべてのリクエストの Method、URL、Name を一覧表示します。
フォルダ構造
Collection 内の folder 階層関係を保持します。
Body プレビュー
リクエストの raw body サマリーを表示します。
ローカル解析
Collection にはイントラネット URL や token 名が含まれる可能性があり、ローカルがより安全です。
フォーマット出力
解析結果を JSON 形式で出力し、二次処理が容易です。
Folder 階層
ディレクトリ構造を保持し、Postman 左側ツリーと同じ組織方式で出力します。
変数プレースホルダー保持
{{baseUrl}} などの変数をそのまま保持し、環境依存を明示します。
HOW TO USE
使用手順
-
1
Postman Collection JSON を貼り付け
-
2
解析後のリクエストサマリーを確認
-
3
コピーまたは編集を続ける
-
4
変換失敗時はエラー表示を確認し、ソースファイルの構文を修正して再試行
-
5
結果をフォーマットツールで整形、または下流スクリプト用にエクスポート
WORKFLOW
典型的なワークフロー
データインポートから結果エクスポートまでの完全フロー。チームで Postman Collection の使い方を統一できます。
Collection をエクスポート
Postman → Export → Collection v2.1 JSON。
貼り付けて解析
JSONSort にインポートし、構造化リクエスト一覧を確認。
閲覧とフィルター
フォーマットツリービューと組み合わせ、個別 request の詳細を確認。
ドキュメント化
サマリーを Wiki / OpenAPI 移行スクリプトにコピー。
USE CASES
適用シーン
バックエンド開発
チーム共有 Postman Collection の構造を Review します。
テクニカルライティング
Collection から API リストを抽出し、インターフェースドキュメントを作成。
テストエンジニア
Collection カバレッジを評価し、すべての endpoint を一覧化。
フロントエンド開発
バックエンド提供 API リストを把握し、Mock インターフェースを計画。
アーキテクト
Collection 規模と重複 endpoint を評価し、API ガバナンスを推進。
新人オンボーディング
Postman タブを1つずつ開かず、チーム全 API を素早く閲覧。
TIPS
使用のコツ
- Postman から Collection v2.1 JSON をエクスポートし、入力欄に貼り付けるだけです。
- 解析後、JSON 結果をフォーマットツールのツリービューにコピーして階層を閲覧できます。
- Collection 内の {{variable}} はそのまま保持され、環境依存の識別が容易です。
- 大型 Collection は folder 単位で分割エクスポートし、個別に解析することをお勧めします。
- Query ツールと組み合わせ、個別リクエストの URL パラメータ構造を分析。
- Insomnia/Bruno へ移行前に、このツールで Collection 規模を把握。
- エクスポート時は v1 や curl 形式ではなく Collection v2.1 を選択。
- 機密 header（Authorization）はサマリーでもキー名が見えるため、共有前に自己で脱敏してください。
- 超大 Collection は folder 分割エクスポートで解析速度向上。
- 解析結果を SQL ツールに渡し、endpoint リスト表を生成できます。
LOCAL VS ONLINE
ローカル vs オンラインツール
JSONSort は純フロントエンドアーキテクチャを堅持。以下の比較が、開発データ処理にローカルツールが適している理由を示します。
TROUBLESHOOTING
よくある誤解とトラブルシューティング
実際の使用で起こりやすい問題と推奨対処法。試行錯誤の時間を削減します。
解析失敗
推奨：Collection JSON であることを確認（Environment や単一 request ではない）。
URL が不完全
推奨：変数未置換は正常。Environment と組み合わせて手動解析。
階層が深すぎる
推奨：folder 単位で Collection を分割して個別解析。
フォーマットバージョン不一致
推奨：v1 Collection は Postman 内で Convert to v2 後にエクスポート。
FAQ
よくある質問
Postman v1 形式に対応？
主に Collection v2 / v2.1 をサポート。v1 は Postman 内で変換エクスポートを推奨。
Environment 変数も解析される？
現在は Collection 自体を解析。Environment JSON は JSON フォーマットツールで閲覧。
OpenAPI に変換できる？
現在は構造化 JSON サマリーを出力。OpenAPI 変換は後続ステップで自分で処理。
Pre-request Script は実行される？
いいえ。JSON の静的解析のみ、スクリプトは実行しません。
Response 例も抽出される？
request 定義に焦点。response 例はオリジナル JSON で確認。
データはサーバーにアップロードされる？
いいえ。JSONSort のすべてのツールはブラウザ内ローカルで動作し、入力内容はバックエンドサーバーに送信されません。
登録やインストールが必要？
不要です。ページを開くだけで使用でき、アカウント不要、クライアントダウンロード不要、PWA オフラインキャッシュにも対応。
どのくらいのファイルサイズに対応？
ブラウザメモリに依存しますが、通常数 MB 級のデータをスムーズに処理できます。超大ファイルは先に分割するかマージ・クリーンツールをご利用ください。