Ubuntu中Postman如何管理API

Ubuntu中Postman管理API的实用指南

一 安装与启动

• 通过 Snap 安装（推荐）：
  • 更新并安装 Snap：sudo apt update && sudo apt install snapd
  • 安装 Postman：sudo snap install postman
  • 启动：在应用菜单搜索 Postman 或命令行输入 postman
• 通过 .deb 包 安装：
  • 从官网下载 .deb：https://www.postman.com/downloads/
  • 安装：sudo dpkg -i /path/to/postman.deb
  • 若依赖缺失：sudo apt-get install -f
  • 启动：应用菜单或命令行输入 postman
• 通过 tar.gz 手动安装：
  • 下载：wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
  • 解压与部署：tar -xvf postman.tar.gz && sudo mv Postman /opt
  • 创建软链：sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  • 可选桌面入口：创建 /usr/share/applications/postman.desktop，Exec 指向 /usr/local/bin/postman，Icon 指向 /opt/Postman/app/resources/app/assets/icon.png

二 组织API 集合与请求

• 创建 Collection（集合） 管理同一模块或服务的所有请求，便于统一维护与分享
• 在集合中 Add request 新建请求，选择 GET/POST/PUT/DELETE 等方法
• 配置 Params/Headers/Body（如 JSON、form-data），点击 Send 发送
• 将相关请求拖入同一集合，使用 Folders 分组；为集合与请求添加 Description 说明用途与变更记录

三 环境与变量管理

• 创建 Environment（环境） 区分 开发/测试/预发/生产 等场景
• 在环境中定义变量（如 baseUrl、apiKey、token），在请求中以 {{变量名}} 引用
• 登录后将 accessToken 写入环境，统一在 Headers 中使用（如 Authorization: Bearer {{token}}）
• 使用 Pre-request Script 动态生成或变换参数（时间戳、签名等），保证请求前置条件一致

四 自动化测试与批量运行

• 在请求的 Tests 标签用 JavaScript 编写断言，验证 状态码、响应头、JSON 字段 等，示例：
  • pm.test(“Status 200”, () => pm.response.to.have.status(200));
  • const json = pm.response.json(); pm.expect(json.code).to.eql(0);
• 使用 Collection Runner 批量运行集合，结合数据文件（如 CSV/JSON）做 数据驱动测试
• 创建 Monitor（监控） 按计划定时执行集合，生成报告并告警，持续验证接口可用性

五 协作与持续集成

• 使用 Workspaces（工作区） 进行团队协作，按项目/团队划分，统一规范与版本
• 将集合与环境 导出/分享 给团队成员，保持接口定义与用例一致
• 与 CI/CD（如 Jenkins、GitLab CI）集成：在流水线中运行 Postman 集合（Newman），根据测试结果控制部署流程