温馨提示×

ubuntu上Postman API测试流程

小樊
39
2025-10-28 23:08:04
栏目: 智能运维

Ubuntu上Postman API测试流程

1. 安装Postman

在Ubuntu上安装Postman有两种常用方式,推荐使用Snap安装(简单快捷)或手动下载安装包(自定义路径):

  • Snap安装
    打开终端,依次执行以下命令安装Snapd(若未安装)及Postman:

    sudo apt update && sudo apt upgrade -y sudo apt install snapd sudo snap install postman --classic 

    安装完成后,通过终端输入postman或从应用菜单启动。

  • 手动下载安装包
    访问Postman官网下载Linux版本(.tar.gz格式),解压至/opt目录并创建全局快捷方式:

    cd ~/Downloads sudo tar -xzf Postman-linux-x64-*.tar.gz -C /opt/ sudo ln -s /opt/Postman/Postman /usr/bin/postman 

    创建桌面图标(可选):

    sudo vim /usr/share/applications/postman.desktop 

    添加以下内容(替换版本号为实际下载的版本):

    [Desktop Entry] Encoding=UTF-8 Name=Postman Exec=/opt/Postman/Postman Icon=/opt/Postman/app/resources/app/assets/icon.png Terminal=false Type=Application Categories=Development; 

    保存后赋予可执行权限:sudo chmod +x /usr/share/applications/postman.desktop

2. 准备API测试基础信息

测试前需明确接口文档中的关键信息,确保请求符合接口要求:

  • 请求方法:GET(查询)、POST(创建)、PUT(更新)、DELETE(删除)等;
  • 请求URL:接口地址(如http://localhost:8080/api/users);
  • 请求头:如Content-Type: application/json(JSON数据格式)、Authorization: Bearer <token>(身份验证);
  • 请求参数:路径参数(如/users/{{id}}中的id)、查询参数(如?page=1&limit=10);
  • 请求体:POST/PUT请求需输入的数据(如JSON格式的{"name": "John", "email": "john@example.com"})。

3. 构造并发送API请求

  • 新建请求:打开Postman,点击左上角+ NewHTTP Request,输入请求名称(如“Get All Users”)并选择/创建集合(用于管理请求);
  • 设置请求参数
    • 选择请求方法(如GET、POST);
    • 输入URL(可点击Params按钮添加路径/查询参数);
    • 切换至Headers tab,添加必要请求头(如Content-Type);
  • 添加请求体(POST/PUT请求):
    选择Body tab→rawJSON,输入请求体(如{"name": "Alice", "age": 25});
  • 发送请求:点击右上角Send按钮,Postman将向接口发送请求并显示响应。

4. 验证API响应

发送请求后,Postman会显示以下响应信息,需逐一验证:

  • 状态码:如200 OK(成功)、400 Bad Request(参数错误)、401 Unauthorized(未授权)、201 Created(创建成功);
  • 响应头:如Content-Type: application/json(数据格式)、Cache-Control: no-cache(缓存策略);
  • 响应体:查看返回的数据内容(如JSON格式的用户列表),确认是否符合业务逻辑(如字段是否存在、数据类型是否正确)。

5. 编写测试断言(自动化验证)

在请求的Tests tab中编写JavaScript脚本,自动验证响应是否符合预期(如状态码、字段存在性、业务逻辑):

  • 常用断言示例
    // 验证状态码为200 pm.test("Status code is 200", function () { pm.response.to.have.status(200); }); // 验证响应体包含特定字段(如"name") pm.test("Response contains 'name' field", function () { const jsonData = pm.response.json(); pm.expect(jsonData).to.have.property("name"); }); // 验证创建用户后返回的name与请求一致 pm.test("Created user name matches request", function () { const requestData = JSON.parse(pm.request.body.raw); const jsonData = pm.response.json(); pm.expect(jsonData.name).to.eql(requestData.name); }); 
    脚本编写完成后,发送请求时会自动执行,结果会在Test Results面板中显示(通过/失败)。

6. 组织与管理请求(集合)

  • 创建集合:将相关请求保存至同一集合(如“User Management”),便于批量管理和复用;
  • 添加请求至集合:创建请求时选择已有集合,或选中请求后点击Save→选择集合;
  • 共享集合:可通过Postman的“Share”功能导出集合为文件(.json),与他人协作或迁移至其他设备。

7. 批量运行测试(Collection Runner)

  • 选择集合:点击左侧Collections,选中需测试的集合;
  • 配置运行参数:点击集合右侧Run按钮,选择迭代次数(如10次)、延迟时间(如1秒/次)、数据文件(如CSV/JSON格式的测试数据,用于参数化);
  • 查看结果:运行完成后,Postman会显示测试报告(包括通过/失败的用例数、响应时间、错误信息),标记失败的用例以便排查。

8. 高级功能(可选)

  • 环境变量:在Environment中创建变量(如{{base_url}}{{token}}),用于切换测试环境(开发、测试、生产)或在请求中动态引用(如{{base_url}}/api/users);
  • Pre-request Script:在发送请求前执行脚本(如生成随机数据、获取Token),用于准备测试数据;
  • 依赖接口测试:通过脚本将上一个接口的返回值(如Token)设置为环境变量,供后续接口使用(如登录接口获取Token后,用于后续的用户操作接口)。

通过以上流程,可在Ubuntu上使用Postman完成API的功能测试、自动化测试及团队协作,确保接口的正确性和稳定性。

0