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 级别的数据。超大文件建议先拆分或使用合并清理工具。