Linux版 Postman 管理 API 请求的实用指南
一 安装与启动
- 使用 Snap(推荐):
- 安装 Snapd:sudo apt update && sudo apt install snapd
- 安装 Postman:sudo snap install postman
- 手动安装(通用):
- 下载并解压:wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- 解压到目录:sudo mkdir -p /opt/postman && sudo tar zxvf postman.tar.gz -C /opt/postman
- 创建软链:sudo ln -s /opt/postman/Postman/Postman /usr/local/bin/postman
- 启动方式:
- 终端输入:postman
- 或在应用菜单搜索 Postman 图标启动。
二 创建与组织请求
- 新建请求:点击左上角 + → HTTP Request,选择方法(如 GET/POST/PUT/DELETE),填写 URL。
- 配置请求:
- Params:添加查询参数(如 ?id=123)
- Headers:如 Content-Type: application/json、Authorization: Bearer
- Body:选择 raw → JSON 输入数据(如 {“name”:“John”})
- 保存与组织:点击 Save,选择或新建 Collection;在集合中使用文件夹、拖拽排序、复制、删除来管理请求。
三 环境与变量管理
- 创建环境:右上角环境选择器 → Manage Environments → Add,添加变量(如 base_url、api_key),区分 Development/Testing/Production。
- 使用变量:在 URL/Headers/Body 中以 {{变量名}} 引用,例如 {{base_url}}/users、Authorization: Bearer {{api_key}}。
- 切换与优先级:通过右上角切换环境;全局变量跨环境可用,且与同名环境变量同名时优先级更高(全局覆盖环境)。
- 导入导出:环境与集合均支持 Import/Export .json,便于备份与团队协作。
四 自动化测试与批量运行
- 编写测试脚本(Tests 选项卡):
- 状态码:pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
- 响应时间:pm.test(“Response time < 200ms”, () => pm.expect(pm.response.responseTime).to.be.below(200));
- JSON 字段:pm.test(“Name is John”, () => pm.expect(pm.response.json().name).to.eql(“John”));
- 批量运行:在集合右侧点击 Run 打开 Collection Runner,配置迭代次数与延迟,查看通过率与报告。
- 命令行与 CI/CD:使用 Newman(Postman CLI)
- 安装:npm install -g newman
- 运行:newman run collection.json -e environment.json --reporters cli,json
- 适用场景:无头环境、自动化流水线、定时回归。
五 协作共享与进阶功能
- 共享与协作:集合右上角 … → Share,可通过链接、邮件或 Postman 团队共享;支持导出 JSON 供版本控制与团队分发。
- Mock Server:在 Postman 中创建 Mock Server,模拟接口返回,便于前后端并行开发调试。
- 导入现有用例:通过 File → Import 导入集合或环境 JSON,快速复用历史请求与配置。