Postman学习：新手入门到上手实操教程

本文介绍了Postman学习的相关内容，包括Postman的下载与安装、基础使用方法、环境变量与集合管理、接口测试与断言以及生成测试报告和分享功能。通过详细步骤和示例，帮助读者掌握Postman学习的关键点。Postman学习不仅涵盖了基本操作，还包括高级功能，如断言和云端同步，使API测试更加高效和便捷。

Postman 是一个强大的 API 测试工具，支持多种 API 调用，如 HTTP、WebSocket、GraphQL 等。它不仅能够发送和接收各种类型的 HTTP 请求，还能够对响应进行深入分析。Postman 可以用来测试 RESTful API 和非 RESTful API，支持自动化测试，并能够生成详细的测试报告。

Postman 可以在多种操作系统上安装，包括 Windows、macOS 和 Linux。以下是下载和安装 Postman 的步骤：

1. 访问 Postman 官方网站 https://www.postman.com/downloads/，选择适合的操作系统进行下载。
2. 下载完成后，双击解压包进行安装。安装过程非常简单，只需按照安装向导的提示操作即可。

安装完成后，打开 Postman 应用程序，你会看到一个简洁的用户界面。

Postman 的主界面分为几个主要部分：

• 导航栏（左侧）：这里包含环境、集合、请求、工作区等选项。
• 请求选择器：显示当前选择的集合和请求。
• 请求面板：用于编写和发送请求。
• 响应面板：显示请求的响应。
• 预览面板：可以查看请求的详细信息，如 Headers、Cookies、Body 等。

在 Postman 中创建一个新请求的具体步骤如下：

1. 在导航栏中选择“Collections”，然后点击“+”号新建一个集合。
2. 在集合中点击“+”号新建一个请求。

下面是一个简单的示例，展示如何创建一个 GET 请求：

// 在Postman中新建一个GET请求
GET https://jsonplaceholder.typicode.com/posts/1

在这个示例中，我们请求了 JSONPlaceholder API 的一个示例数据。

HTTP 方法是指客户端向服务器发送请求时所使用的动作。 Postman 支持多种 HTTP 方法，包括 GET、POST、PUT、DELETE 等。每种方法对应不同的操作：

• GET：用于从服务器获取数据，是最常见的 HTTP 方法。
• POST：用于向服务器发送数据，通常用于创建新资源。
• PUT：用于更新服务器上的资源，通常用于完全替换资源。
• DELETE：用于删除服务器上的资源。
• PATCH：用于更新服务器上的资源，通常用于部分更新。

下面是一个 POST 请求的例子：

// 在Postman中新建一个POST请求
POST https://jsonplaceholder.typicode.com/posts

Body:
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

这个请求将向 JSONPlaceholder API 发送一个新的博客文章。

在 Postman 中填写和测试 URL 的步骤如下：

1. 在 Requests 面板中输入 URL。
2. 在 Body 部分配置请求体（如果需要的话）。
3. 点击“Send”按钮发送请求，并查看响应。

下面是一个完整的 POST 请求示例：

// 在Postman中新建一个POST请求
POST https://jsonplaceholder.typicode.com/posts

Headers:
Content-Type: application/json

Body:
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

Query 参数用于在 URL 中传递额外的信息。例如，可以在 URL 后面加上问号 ?，然后追加参数。

示例：

// 在Postman中新建一个GET请求
GET https://jsonplaceholder.typicode.com/posts?userId=1

Headers:
Content-Type: application/json

这个示例将请求 JSONPlaceholder API 的特定用户的文章。

表单数据提交通常使用 POST 请求，并且在 Body 部分选择 form-data 选项。例如：

// 在Postman中新建一个POST请求
POST https://httpbin.org/post

Body:
form-data
key1: value1
key2: value2

这个示例将向 httpbin.org 发送表单数据。

Body 部分有多种配置选项，具体如下：

• raw：用于发送原始文本，支持 JSON、Text、XML 等格式。
• form-data：用于发送表单数据。
• x-www-form-urlencoded：用于发送 URL 编码的数据。
• binary：用于上传文件。

示例：

// 在Postman中新建一个POST请求
POST https://jsonplaceholder.typicode.com/posts

Headers:
Content-Type: application/json

Body:
raw
{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

环境变量可以在 Postman 中创建，用于存储可以重复使用的数据，如 API 密钥、域名等。具体步骤如下：

1. 点击右上角的 "Environments"，然后点击“+”号新建一个环境。
2. 添加变量并设置值。
3. 在请求中使用这些变量。

示例：

// 创建一个新的环境变量
Environment Name: Dev
Variables:
  api_key: 123456
  base_url: https://api.example.com

// 在请求中使用环境变量
GET {{base_url}}/users?apiKey={{api_key}}

集合用于组织相关的请求，可以在集合中创建文件夹来进一步分类。具体步骤如下：

1. 在左侧导航栏选择“Collections”，点击“+”号创建一个新的集合。
2. 在集合内创建文件夹，将请求放入相应的文件夹中。

示例：

// 创建一个集合并添加文件夹
Collection Name: API Testing

// 在集合中创建文件夹
Folder Name: User Management

// 将请求放入文件夹中
Request Name: Get User
Request URL: GET https://api.example.com/users

在集合内创建文件夹，根据请求的功能类型进行分类，便于管理和测试。

示例：

// 创建一个集合并添加文件夹
Collection Name: API Testing

// 创建文件夹
Folder Name: User Management

// 添加请求
GET https://api.example.com/users
POST https://api.example.com/users
PUT https://api.example.com/users/1
DELETE https://api.example.com/users/1

断言是用于验证请求响应是否符合预期的一种方法。断言可以在响应头、响应体或响应状态码等方面进行检查。

示例：

// 添加断言来验证响应状态码
Tests:
pm.test("Status code is 200", function() {
  pm.response.to.have.status(200);
});

// 添加断言来验证响应体中的特定数据
pm.test("Response contains 'foo'", function() {
  pm.expect(pm.response.json().title).to.equal("foo");
});

// 添加断言来验证响应头
pm.test("Content-Type is application/json", function() {
  pm.expect(pm.response.headers.get('Content-Type')).to.equal('application/json');
});

在 Postman 中添加断言的方法如下：

1. 在请求面板中，点击“Tests”标签，添加测试脚本。
2. 使用 Postman 的测试脚本语言 pm 来编写断言。

示例：

// 在Postman中添加一个断言
Tests:
pm.test("Status code is 200", function() {
  pm.response.to.have.status(200);
});

pm.test("Response contains correct username", function() {
  var jsonData = pm.response.json();
  pm.expect(jsonData.username).to.equal("testuser");
});

pm.test("Content-Type is application/json", function() {
  pm.expect(pm.response.headers.get('Content-Type')).to.equal('application/json');
});

假设我们需要测试一个用户注册接口，包含以下几个断言：

1. 用户注册成功后，响应状态码应该为 200。
2. 响应体中的用户名应该与请求中提供的用户名一致。
3. 响应头中的 Content-Type 应该为 application/json。

示例：

// 在Postman中测试用户注册接口
POST https://api.example.com/register

Headers:
Content-Type: application/json

Body:
raw
{
  "username": "testuser",
  "password": "testpassword"
}

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

pm.test("Response contains correct username", function() {
  var jsonData = pm.response.json();
  pm.expect(jsonData.username).to.equal("testuser");
});

pm.test("Content-Type is application/json", function() {
  pm.expect(pm.response.headers.get('Content-Type')).to.equal('application/json');
});

在 Postman 中生成测试报告的方法如下：

1. 在左侧导航栏选择“Collections”，选择相应的集合。
2. 点击右上角的 “Runner” 按钮，选择“Collection Runner”。
3. 选择要运行的集合和环境，点击“Execute”按钮。
4. 执行完成后，可以在右侧查看详细的测试报告。

示例：

// 生成测试报告
1. 选择Collection - "API Testing"
2. 点击右上角的 "Runner" 按钮
3. 选择 "Collection Runner"
4. 选择环境 - "Dev"
5. 点击 "Execute"

在 Postman 中分享集合和环境的方法如下：

1. 选择需要分享的集合或环境。
2. 点击右上角的 “Share” 按钮。
3. 选择分享方式（如 URL、电子邮件等），并生成链接。
4. 将生成的链接发送给需要分享的人。

示例：

// 分享集合和环境
1. 选择Collection - "API Testing"
2. 点击右上角的 "Share" 按钮
3. 选择分享方式 - "URL"
4. 复制生成的URL，发送给需要分享的人

Postman 提供了云端功能，可以保存和同步集合、环境等配置，方便在不同设备间使用。

1. 登录 Postman 账户。
2. 在左侧导航栏选择“Workspaces”，点击“New Workspace”创建新的工作空间。
3. 将集合和环境同步到工作空间中，以便在云端保存和共享。

示例：

// 使用云端功能
1. 登录Postman账户
2. 在左侧导航栏选择 "Workspaces"
3. 点击 "New Workspace" 创建新的工作空间
4. 将集合同步到工作空间中
5. 选择 "Sync to Workspace" 同步环境和集合