一、在Ubuntu上安装Postman
Postman支持多种方式在Ubuntu上安装,以下是三种常见方法:
Snap安装(推荐,最简方式)
打开终端,依次执行以下命令更新系统并安装Postman:
sudo apt update && sudo apt upgrade -y
sudo snap install postman --classic
安装完成后,通过应用程序菜单或终端输入postman
启动。
手动下载安装包
访问Postman官网下载Linux版本安装包(如Postman-linux-x64-XX.X.X.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
通过npm安装(适合开发人员)
若已安装Node.js和npm,可直接通过以下命令全局安装:
sudo npm install -g postman
安装完成后,通过postman
命令启动。
二、使用Postman进行API测试
创建并发送单个请求
启动Postman后,点击左侧“+”号新建请求,选择HTTP方法(GET/POST/PUT/DELETE等),输入API URL(如https://api.example.com/users
)。根据需求设置请求头(Headers,如Content-Type: application/json
)或请求体(Body,如JSON格式数据),点击右上角“Send”按钮发送请求。响应结果将显示在下方的“Response”面板中,包含状态码(如200表示成功)、响应头(Headers)和响应体(Body)。
组织测试集合(Collections)
为便于管理多个相关请求,可将请求保存至集合。点击左侧“Collections”→“+ New Collection”,输入集合名称(如“User API Tests”),点击“Create”。发送请求后,点击“Save”按钮,选择对应的集合即可将请求归类。集合可用于批量运行测试、导出或共享。
编写测试脚本(Assertions)
在请求的“Tests”标签页中,使用JavaScript编写断言脚本验证响应是否符合预期。常见示例:
pm.test("Status code is 200", function() {
pm.response.to.have.status(200);
});
pm.test("Response contains 'success'", function() {
pm.expect(pm.response.text()).to.include("success");
});
pm.test("Response time is less than 200ms", function() {
pm.expect(pm.response.responseTime).to.be.below(200);
});
脚本编写完成后,发送请求时会自动执行断言,结果将显示在“Test Results”面板中。
运行测试集合
点击左侧集合右侧的“Run”按钮,打开Runner界面。选择要运行的集合,设置迭代次数(如1次)、环境变量(可选),点击“Run [Collection Name]”。Runner将依次执行集合中的所有请求,并汇总测试结果(包括通过/失败的断言数量、响应时间等),点击“Test Results”可查看每个请求的详细测试情况。
三、自动化测试(可选,使用Newman)
若需要将API测试集成至CI/CD流程(如Jenkins、GitHub Actions),可使用Postman的命令行工具Newman。
安装Newman
在终端执行以下命令(需提前安装Node.js和npm):
sudo npm install -g newman
导出Postman集合
在Postman中选中要导出的集合,点击右侧“···”→“Export”,选择导出格式为“Collection v2.1”(兼容性更好),保存为JSON文件(如user-api-tests.json
)。
运行Newman测试
在终端执行以下命令(替换为实际文件路径):
newman run user-api-tests.json
若需要传递环境变量(如API基础URL),可添加--environment
参数:
newman run user-api-tests.json --environment env.json
Newman将执行集合中的所有请求,并生成命令行测试报告(支持JSON、HTML等格式)。