Ubuntu上Postman的API测试方法

Ubuntu上Postman的API测试方法

一 安装与启动

• 使用 Snap（推荐）：
  • 安装与启动：sudo snap install postman --classic
• 使用 APT 仓库：
  • 导入密钥与源并安装：
    • wget -qO - https://dl.postman.co/postman.gpg | sudo apt-key add -
    • echo “deb https://dl.postman.co/debian $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/postman.list
    • sudo apt update && sudo apt install postman
• 使用 Flatpak：
  • 安装与运行：
    • sudo apt install flatpak
    • flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
    • flatpak install flathub com.postman.Postman
• 手动安装（下载解压方式）：
  • 下载与解压：
    • wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
    • sudo tar -xzf postman.tar.gz -C /opt/
  • 创建软链与桌面入口：
    • sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
    • 创建文件 /usr/share/applications/postman.desktop，内容示例：
      • [Desktop Entry]
      • Name=Postman
      • Exec=/opt/Postman/Postman
      • Icon=/opt/Postman/app/resources/app/assets/icon.png
      • Terminal=false
      • Type=Application
      • Categories=Development;
    • 更新桌面数据库：sudo update-desktop-database
• 启动方式：应用菜单搜索 Postman 或终端执行 postman。

二 创建请求与集合

• 新建集合：点击左上角 New > Collection，命名如 API Tests，用于组织相关接口。
• 新建请求：在集合中 Add request，选择方法（如 GET/POST/PUT/DELETE），填写 URL。
• 配置请求：
  • Params：添加查询参数
  • Headers：如 Content-Type: application/json
  • Body：选择 raw > JSON 并填写请求体
• 发送与查看：点击 Send，在下方查看 Status、Time、Headers、Body（支持 Pretty/Raw/Preview）。

三 断言与自动化测试

• Tests 断言示例（在请求右侧 Tests 标签）：
  • 验证状态码：pm.test(“状态码为200”, () => pm.response.to.have.status(200));
  • 验证字段值：pm.test(“用户名正确”, () => { const json = pm.response.json(); pm.expect(json.name).to.eql(“test_user”); });
• Pre-request Script：在发送前设置变量、时间戳、签名等，例如生成 nonce 或读取环境变量。
• 批量运行：使用 Collection Runner 批量执行集合，配置迭代次数、数据文件、环境等，查看每个请求的断言结果。

四 环境与授权管理

• 环境变量：点击右上角 Manage Environments > Add，添加变量如 baseUrl、API_KEY；在请求中使用 {{baseUrl}}、{{API_KEY}} 引用。
• 动态取令牌：登录后在 Tests 中将 access_token 写入环境，供后续请求统一引用：
  • 示例：pm.environment.set(“access_token”, pm.response.json().access_token);
• 认证方式：在 Authorization 标签选择 Bearer Token，值填 {{access_token}}；也可配置 Basic Auth、API Key 等。

五 调试与CI集成

• 调试技巧：
  • 使用 console.log 输出调试信息，在 Postman 控制台查看日志
  • 通过 Tests 与 Pre-request Script 分段验证参数与响应
  • 使用 Collection Runner 重放请求，定位偶发问题
• 监控与报告：
  • 使用 Postman Monitor 定期执行集合并生成报告
• CI/CD 集成（Newman）：
  • 安装：npm install -g newman
  • 执行：导出集合为 collection.json，运行 newman run collection.json
  • 可结合 Jenkins/GitLab CI 等流水线执行并解析结果。