Postman介绍及使用

Postman 是一个强大的 API 开发、测试和文档化工具，广泛用于开发者、测试人员和 API 设计者。以下是 Postman 的核心使用指南，涵盖基础操作到进阶功能：

一、基础使用

1. 安装与界面

   • 下载：官网下载（支持 Windows/macOS/Linux）
   • 界面组成：
     • 侧边栏：Collections（集合）、APIs（API 文档）、Environments（环境变量）
     • 主工作区：请求构建区、响应展示区

2. 发送第一个请求

   • 新建请求 → 选择方法（GET/POST 等）→ 输入 URL（如 https://jsonplaceholder.typicode.com/posts/1）→ 点击 Send。
   • 查看响应：Body（数据）、Headers（头信息）、Status Code（状态码）。

3. 管理请求集合（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
• 切换环境：右上角环境选择器。

三、自动化测试

1. 编写测试脚本（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);
   });
   

2. 预请求脚本（Pre-request Script）

   • 在发送请求前执行（如生成签名、时间戳）：

   // 设置变量
   pm.environment.set("token", "temp_token");
   

四、高级功能

1. Mock 服务器

   • 创建 Mock Server：为集合生成模拟 API，返回预设响应。
   • 用途：前端开发无需等待后端完成。

2. 监控（Monitors）

   • 定时运行集合：每天检查 API 健康状态（需登录账户）。

3. 文档生成

   • 集合右键 → View Documentation：自动生成 API 文档并分享链接。

4. 工作流（Collection Runner）

   • 批量运行集合中的请求：
     • 设置迭代次数
     • 使用数据文件（JSON/CSV）驱动测试

五、快捷键

• Ctrl + Enter / Cmd + Enter：发送请求
• Ctrl + S / Cmd + S：保存请求
• Ctrl + B：聚焦到 URL 输入框

六、常见问题

1. 变量不生效？

   • 检查环境是否选中 → 变量名拼写（{{name}}）→ 作用域（全局/环境/集合）。

2. 跨域问题（CORS）？

   • Postman 不受浏览器跨域限制，但测试时若遇到需后端配置 CORS 头。

3. 保存响应数据

   • 响应区点击 Save Response → 保存为文件。

七、学习资源

• 官方文档：https://learning.postman.com/
• 模板库：Template → 搜索 GitHub/Twitter 等 API 模板

通过 Postman，你可以高效管理 API 生命周期。遇到具体问题（如 OAuth 配置、脚本编写）可进一步提问！