简介

Postman 是一款强大的 API 开发和接口测试工具

能帮助开发人员和测试人员高效地与各种 API 进行交互、发送请求并分析响应。

https://www.postman.com/

部署

以Windows为例：

1.傻瓜式下载并安装

https://www.postman.com/downloads/

界面概览

打开 Postman 后，您将看到以下主要区域（如图 1 所示）：

导航栏：包含常用操作的菜单，如新建请求、集合、环境等。

请求编辑区：在此输入 API 请求的详细信息，包括请求方法、URL、请求头、请求体等。

响应区：显示 API 请求的响应结果，包括状态码、响应头、响应体等信息。

侧边栏：用于管理请求集合、环境变量、历史记录等。

发送简单请求

GET与POST的区别

① 长度。GET有长度限制，POST没有长度限制。

② 安全性。GET通常是将参数显示在URL地址中，可以被看见，不是那么安全；而POST是将参数写入body中，不能被看见，更安全。

③ 作用。GET通常作用于从数据库中读取数据；而POST则是将数据提交/更新于数据库中。

GET

无参数的GET方法

有参数的GET方法

POST

用户注册

用户登录

实例流程

创建请求

  1. 点击“New”按钮，选择“HTTP Request”创建一个新的请求（如图 2 所示）。

  2. 在请求编辑区的 URL 输入框中输入要测试的 API 地址，例如：https://api.example.com/users。

  3. 选择请求方法，如 GET、POST、PUT、DELETE 等。这里我们先使用 GET 方法获取用户信息。

发送请求并查看响应

  1. 点击“Send”按钮发送请求

  2. 在响应区可以看到 API 返回的状态码（如 200 OK 表示请求成功）、响应头和响应体信息。响应体通常是 JSON 格式的数据，Postman 会自动格式化以便查看

设置请求头

添加请求头

在请求编辑区的“Headers”标签下，点击“Key”和“Value”输入框，分别输入请求头的键和值。例如，添加一个“Content-Type”请求头，值为“application/json”（如图 5 所示）。这在发送需要特定请求头的 API 请求时非常重要，比如 POST 请求携带 JSON 数据时

断言

高级使用

使用环境变量

  1. 点击侧边栏的“Environments”按钮，然后点击“New Environment”创建一个新的环境

  2. 为环境命名，例如“Development”，并在“Initial Value”和“Current Value”列中添加变量及其对应的值。比如，我们添加一个名为“base_url”的变量，值为“https://api.example.com”

  1. 在请求编辑区的 URL 中，将之前硬编码的域名部分替换为环境变量，使用双花括号括起来，如{{base_url}}/users

  1. 点击右上角的环境选择器，选择刚刚创建的“Development”环境（如图 9 所示）。这样，当我们切换环境时，请求的基础 URL 会相应改变，方便在不同环境（开发、测试、生产等）下进行 API 测试。

创建请求集合与文件夹

创建请求集合

  1. 点击“New”按钮，选择“Collection”创建一个新的请求集合

  2. 为集合命名，例如“User API Collection”，这个集合将用于组织和管理与用户相关的 API 请求

在集合中添加请求并创建文件夹

选中刚刚创建的“User API Collection”集合，点击“Add Request”将之前创建的获取用户信息的请求添加到集合中

可以在集合中创建文件夹来进一步分类管理请求。右键点击集合名称，选择“Add Folder”，为文件夹命名，如“User Operations”，然后将请求拖放到相应的文件夹中

这样可以使请求结构更加清晰，便于维护和批量操作。

使用脚本进行自动化测试

在请求编辑区的“Tests”标签下，可以编写 JavaScript 测试脚本。

例如，可以编写一个简单的测试脚本来验证响应状态码是否为 200，并检查响应体中是否包含特定的字段

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

pm.test("Response contains user data", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('name');
    pm.expect(jsonData).to.have.property('email');
});

点击“Send”按钮发送请求后，Postman 会自动运行“Tests”标签下的测试脚本，并在“Test Results”面板中显示测试结果

通过编写测试脚本，可以实现 API 的自动化测试，提高测试效率和准确性。

使用 Newman 进行命令行运行测试

  1. 安装 Newman

Newman 是 Postman 的命令行工具，可以在命令行中运行 Postman 集合中的测试。

首先确保已经安装了 Node.js，然后在命令行中使用 npm 安装 Newman

npm install -g newman

  1. 导出 Postman 集合

在 Postman 中，点击集合名称旁边的“…”按钮，选择“Export”，将集合导出为 JSON 格式

  1. 在命令行中运行测试

在命令行中切换到导出的集合 JSON 文件所在目录，然后使用以下命令运行测试

newman run <collection_file.json>

例如：newman run User_API_Collection.json。

Newman 会运行集合中的所有请求，并显示详细的测试结果

这对于将 API 测试集成到持续集成/持续交付（CI/CD）流程中非常有用。