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 客戶端中逐個開啟。
適合團隊 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
適用場景
後端開發
Review 團隊共享的 Postman Collection 結構。
技術寫作
從 Collection 提取 API 列表編寫介面文件。
測試工程師
評估 Collection 覆蓋率，列出全部 endpoint。
前端開發
瞭解後端提供的 API 清單，規劃 Mock 介面。
架構師
評估 Collection 規模與重複 endpoint，推動 API 治理。
新人 onboarding
快速瀏覽團隊全部 API 而不逐個開啟 Postman tab。
TIPS
使用技巧
- 從 Postman 匯出 Collection v2.1 JSON，貼上到輸入框即可。
- 解析後可複製 JSON 結果到格式化工具樹檢視瀏覽層級。
- Collection 中的 {{variable}} 會原樣保留，便於識別環境依賴。
- 大型 Collection 建議先按 folder 拆分匯出，分別解析。
- 結合 Query 工具分析單個請求的 URL 參數結構。
- 遷移到 Insomnia/Bruno 前，先用此工具摸清 Collection 規模。
- 匯出時選 Collection v2.1 而非 v1 或 curl 格式。
- 敏感 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 級別的資料。超大檔案建議先拆分或使用合併清理工具。