接口测试 - postman

1. 简单介绍

• Postman 是接口测试工具，网页调试工具，可调试 HTTP/HTTPS 接口，也可简单调试 html、css。
• 支持多操作系统：Windows、Linux、MacOS（32/64 位）

2. 安装步骤

• 下载地址 https://dl.pstmn.io/download/version/9.31.30/win64
• 双击下载好的安装包
• 可以跳过登录，不用注册账号
• 进入 Postman 主界面即可使用

3. 基础使用

• 新建集合，自定义集合名称
• 点击 + 新建请求标签页
• 选择请求方法，填写接口url
• 切换 body，选择参数格式，填写入参
• 保存请求：自定义接口名称，保存到刚才创建的集合内
• 点击 Send 发送请求，查看响应体、响应头

4. HTTP 请求四要素
   URL、请求Method、Headers、Body
   Body 四种类型

• form-data：表单，支持key-value，可以上传文件
• x-www-form-urlencoded：普通表单键值对，不能传文件
• raw：原始文本，常用 JSON / XML，选JSON格式时，请求头自动带上 Content-Type:application/json
• binary：上传二进制文件（图片，音频，视频）

响应体三种查看模式

• Pretty：格式化美化 JSON/XML，阅读方便【最常用】
• Raw：原始未加工返回数据
• Preview：渲染HTML页面预览

5. 接口依赖（Cookie保持会话）
   多个接口连续调用，需要保持 Cookie 一致
   例：先调用登录接口，再调用查询用户接口；登录成功后 Postman 自动保存 Cookie，后续请求自动携带，保持会话。

6. 环境变量（参数化，{{变量名}}）
   作用：提取数据，统一管理参数，实现参数复用

• 使用双大括号引用变量：{{变量名}}
• 创建环境，添加环境变量，填写变量值
• 右上角选择创建好的环境
• Send 发送，自动替换变量执行

7. 集合导入导出

• 导入：点击import，导入json 接口文件
• 导出：Export，选择版本，保存json 文件

8. Tests 断言【⭐️】

快捷键注释：ctrl + /
卸载Tests 面板，请求响应回来后自动执行，用来校验结果是否符合预期。

点击查看代码

// 断言响应文本包含字符串
pm.test("Body matches string", function () {
    pm.expect(pm.response.text()).to.include("登录成功");
});
// 断言响应时间小于200ms
pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});
// 断言HTTP状态码为200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

9. 集合批量运行

• 选中集合右键 -> Run
• 配置：选择集合、环境变量、循环次数、请求延迟、数据文件
• 执行Run
• 查看结果：统计通过、失败的断言数量

10. 参数化（TXT 文件）

• 新建txt，逗号分隔多组数据
• 请求中使用{{变量名}}引用
• Runner 导入txt文件，选择对应文件类型，执行

11. 接口关联 ⭐

含义：提取上一个接口返回的数据，作为下一个接口的入参
示例：省份接口返回省份名称，传给城市接口作为入参
步骤：

• 先调通两个接口
• 下游接口参数写成变量{{cs}}
• 在上游接口的 Tests 编写代码，提取返回值，存入环境变量

点击查看代码

// xml转json
var jsonObject = xml2Json(responseBody);
// 获取省份数组
js=jsonObject.ArrayOfString.string
// 取数组第5个省份，存入环境变量cs
pm.environment.set("cs", js[5]);

* 执行上游接口，环境变量生成数据 * 执行下游接口，自动读取变量完成关联

12. Token 关联实战案例
    业务链路：获取 uuid 接口 → 登录接口 → 需要 token 的菜单接口

• 接口 1：获取 uuid（/apis/auth/code），提取 uuid 存入环境变量
• 接口 2：登录接口（/apis/auth/login），请求体携带 username、password、code、{{uuid}}
  登录成功返回 token，Tests 提取 token 保存为环境变量：

var jsonData = pm.response.json();
pm.environment.set("t",jsonData.token );

• 接口 3：菜单接口，请求头添加 Authorization: {{t}}，携带 token 鉴权

⚠️注意：JSON 请求必须确认请求头 Content-Type: application/json

13. 记忆要点
    环境变量双大括号引用，Tests 写断言；
    接口关联上游提取存变量，下游 {{变量}} 使用；
    Collection Runner 批量跑，CSV/TXT 做参数化。