UD5工具箱
什么是 Postman Collection？
Postman Collection 是一种标准化的 API 描述格式，基于 JSON 编写，可以包含多个 API 请求、文件夹结构、认证信息、环境变量等配置。它是目前最流行的 API 测试文档交换格式，支持 v2.0 和 v2.1 两个版本。在 Postman 桌面应用中，用户可以将一组相关的 API 请求组织成一个 Collection，方便管理和复用。本工具能够直接导入并运行这种格式的文件，无需安装 Postman 桌面客户端。
如何导出 Postman Collection？
在 Postman 桌面应用中，右键点击您要导出的 Collection，选择「Export」选项，然后在弹出的对话框中选择「Collection v2.1」格式（推荐使用 v2.1 以获得最佳兼容性），点击导出即可生成一个
.json 文件。将该文件保存到本地后，在本工具中点击「导入 Collection」按钮或直接拖拽该文件到页面指定区域即可完成导入。整个过程只需几秒钟。为什么有些 API 请求会失败？（CORS 问题）
浏览器安全策略会阻止跨域请求（CORS），如果目标 API 服务器未设置允许跨域的响应头（如
Access-Control-Allow-Origin），请求会被浏览器拦截并报错。解决方法有三种：① 使用本工具的 CORS 代理功能，在「CORS 代理」输入框中填写代理服务器 URL 前缀，让请求通过代理中转；② 使用浏览器 CORS 扩展临时禁用跨域检查（仅限开发环境）；③ 在服务端配置 CORS 白名单。对于同源请求或已配置 CORS 的公开 API，可直接运行无需额外设置。如何使用环境变量？
在左侧面板中点击「环境变量」按钮展开变量配置面板，添加键值对，例如变量名设为
base_url，值设为 https://api.example.com。然后在请求的 URL、Headers 或 Body 中使用 {{base_url}} 语法引用该变量。发送请求前，工具会自动将所有 {{变量名}} 替换为对应的值。支持嵌套引用，即变量值中也可以包含其他变量占位符。这一机制让您在不同环境间切换时，只需修改变量值，无需逐个修改每个请求。这个工具与 Postman 有什么区别？
本工具是轻量级浏览器端运行器，无需安装任何软件，打开浏览器即可使用，适合快速测试、分享和演示 API 场景。相比 Postman 桌面版，本工具缺少脚本执行（Pre-request Script / Tests）、Mock Server、团队协作、请求历史记录、Monitors 定时运行等高级功能。但本工具覆盖了日常 API 调试所需的核心能力，包括导入 Collection、运行请求、环境变量、CORS 代理等。所有请求直接从浏览器发出，数据不会经过第三方服务器，更加轻便和安全。
支持哪些请求方法和 Body 格式？
本工具支持 HTTP 协议中的所有主流请求方法，包括 GET、POST、PUT、PATCH、DELETE、HEAD 和 OPTIONS 共七种。Body 格式支持三种类型：raw JSON（直接发送 JSON 字符串，适合 RESTful API）、x-www-form-urlencoded（传统表单提交格式）和 form-data（支持文件上传的 multipart 表单）。Headers 和 Query Parameters 完全可自定义添加、编辑和删除。此外，也支持导入 Postman Collection 中的 GraphQL 请求（作为 raw body 处理）。
导入的 Collection 文件会上传到服务器吗？
不会。所有导入的 Collection 文件完全在浏览器本地内存中解析和处理，不会通过网络上传到任何服务器。环境变量、请求参数、响应结果等数据同样仅存在于浏览器内存中。关闭页面后，所有数据即刻消失，不会在本地留下任何痕迹。这一设计从根本上保护了用户的 API 密钥和商业机密安全。
如何将 Collection 导出为其他格式？
本工具目前专注于 Collection 的导入和运行功能，暂不支持将 Collection 导出为其他格式。如果您需要导出或转换 Collection 格式，建议直接在 Postman 桌面应用中操作。在 Postman 中，右键点击 Collection 即可选择导出为 v2.0 或 v2.1 格式。本工具的定位是「快速运行」而非「编辑管理」，保持轻量和专注。
支持哪些版本的 Postman Collection？
本工具支持 Postman Collection v2.0 和 v2.1 两个版本格式，这两个版本覆盖了绝大多数用户在 Postman 中创建的 Collection。如果您使用的是更早期的 v1.0 格式，需要先在 Postman 中将其升级为 v2.1 格式后再导入。建议导出时始终选择 v2.1 格式，以获得最佳的兼容性和功能支持。