Postman 是一个强大的 API 开发、测试和文档化工具,广泛用于开发者、测试人员和 API 设计者。以下是 Postman 的核心使用指南,涵盖基础操作到进阶功能:
一、基础使用
-
安装与界面
- 下载:官网下载(支持 Windows/macOS/Linux)
- 界面组成:
- 侧边栏:Collections(集合)、APIs(API 文档)、Environments(环境变量)
- 主工作区:请求构建区、响应展示区
-
发送第一个请求
- 新建请求 → 选择方法(GET/POST 等)→ 输入 URL(如
https://jsonplaceholder.typicode.com/posts/1
)→ 点击 Send。 - 查看响应:Body(数据)、Headers(头信息)、Status Code(状态码)。
- 新建请求 → 选择方法(GET/POST 等)→ 输入 URL(如
-
管理请求集合(Collections)
- 创建集合:点击 + → 命名集合(如 “项目API”)。
- 添加请求:右键集合 → Add Request → 保存请求到集合。
二、核心功能
1. 参数与身份认证
- Query Params:URL 后加
?key=value&key2=value2
- Headers:添加
Content-Type: application/json
等 - 认证(Authorization):
- Bearer Token:直接填入 Token
- Basic Auth:输入用户名/密码
- OAuth 2.0:配置 Token 获取流程
2. 请求体(Body)
- raw:JSON/XML 等格式(常用
application/json
)
{"title": "Postman Guide","body": "Hello API!","userId": 1
}
- form-data:上传文件或表单数据
- x-www-form-urlencoded:标准表单编码
3. 环境变量(Environments)
- 创建环境(如 “Dev” / “Prod”):
- 添加变量(如
base_url = https://api.dev.com
)
- 添加变量(如
- 使用变量:请求 URL 中写
{{base_url}}/login
- 切换环境:右上角环境选择器。
三、自动化测试
-
编写测试脚本(Tests 标签页)
- 使用 JavaScript 验证响应:
// 检查状态码 pm.test("Status 200", () => pm.response.to.have.status(200));// 验证 JSON 数据 pm.test("Check user ID", () => {const jsonData = pm.response.json();pm.expect(jsonData.userId).to.eql(1); });
-
预请求脚本(Pre-request Script)
- 在发送请求前执行(如生成签名、时间戳):
// 设置变量 pm.environment.set("token", "temp_token");
四、高级功能
-
Mock 服务器
- 创建 Mock Server:为集合生成模拟 API,返回预设响应。
- 用途:前端开发无需等待后端完成。
-
监控(Monitors)
- 定时运行集合:每天检查 API 健康状态(需登录账户)。
-
文档生成
- 集合右键 → View Documentation:自动生成 API 文档并分享链接。
-
工作流(Collection Runner)
- 批量运行集合中的请求:
- 设置迭代次数
- 使用数据文件(JSON/CSV)驱动测试
- 批量运行集合中的请求:
五、快捷键
Ctrl + Enter
/Cmd + Enter
:发送请求Ctrl + S
/Cmd + S
:保存请求Ctrl + B
:聚焦到 URL 输入框
六、常见问题
-
变量不生效?
- 检查环境是否选中 → 变量名拼写(
{{name}}
)→ 作用域(全局/环境/集合)。
- 检查环境是否选中 → 变量名拼写(
-
跨域问题(CORS)?
- Postman 不受浏览器跨域限制,但测试时若遇到需后端配置 CORS 头。
-
保存响应数据
- 响应区点击 Save Response → 保存为文件。
七、学习资源
- 官方文档:https://learning.postman.com/
- 模板库:Template → 搜索 GitHub/Twitter 等 API 模板
通过 Postman,你可以高效管理 API 生命周期。遇到具体问题(如 OAuth 配置、脚本编写)可进一步提问!