操作流程概览
以下步骤将引导您完成从导入 Postman Collection 到成功运行 API 请求的全过程。整个流程无需注册账号或安装软件,打开浏览器即可开始。
第一步:导入 Collection 文件
打开 工具页面,您可以通过两种方式导入 Collection:点击页面顶部的「导入 Collection」按钮,从本地选择 .json 格式的 Postman Collection 文件;或者直接将文件拖拽到页面中央的拖拽区域。工具支持 Postman Collection v2.0 和 v2.1 两种版本格式。
如果您没有现成的 Collection,可以点击「加载示例」按钮快速加载一个示范文件。
第二步:查看 API 列表
导入成功后,左侧面板会显示 API 列表,其中包含 Collection 中的所有请求。每个请求会显示其 HTTP 方法(如 GET、POST)和路径信息。列表上方会显示请求总数,帮助您了解当前 Collection 的规模。您可以点击列表中的任意请求来查看和编辑其详细配置。
第三步:配置环境变量
点击「环境变量」按钮展开变量配置面板。在这里添加键值对,例如将 base_url 设置为 https://api.example.com。然后在请求的 URL、Headers 或 Body 中使用 {{base_url}} 语法引用该变量。工具会在发送请求前自动将所有 {{变量名}} 替换为对应的值。支持在变量值中引用其他变量,实现嵌套替换。
第四步:配置请求详情
选中一个 API 请求后,可以在右侧面板中编辑其详细配置。包括:选择 HTTP 方法(GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS);编辑 URL 和 Query Parameters;自定义 Headers(如 Content-Type、Authorization);配置 Body 类型(raw JSON / x-www-form-urlencoded / form-data)并填写请求体内容。
第五步:设置 CORS 代理(可选)
如果目标 API 服务器未配置 CORS 允许跨域访问,请求会被浏览器拦截。此时可以在「CORS 代理」输入框中填写代理服务器的 URL 前缀。请求发出时,工具会将目标 URL 拼接到代理 URL 后面,通过代理服务器中转请求,从而绕过跨域限制。对于已配置 CORS 的公开 API,无需设置代理。
第六步:发送请求并查看结果
配置完成后,点击「发送」按钮执行当前请求,或点击「运行全部」批量执行所有请求。发送过程中会显示「等待请求...」的加载状态。请求完成后,响应结果会展示在页面下方,包括状态码、响应头和响应体。您可以根据响应内容判断 API 是否正常工作,快速定位问题。
UD5工具箱