Postman中文版：API开发与测试工具

本文还有配套的精品资源，点击获取

简介：Postman是一个广受欢迎的API开发和测试工具，提供了包括请求发送、集合管理、环境变量设置、预请求与测试脚本编写、文档生成、团队协作分享、API监控、模拟服务器和集成其他开发工具等核心功能。该压缩包包含了帮助中文用户理解和使用Postman的所有资源，包括中文语言包、用户手册和教程等，旨在为中国用户提供语言支持和更好的使用体验。

1. Postman介绍与功能概述

Postman是一款在IT行业内广受欢迎的API测试工具，它通过简化API请求的发送过程，极大地提高了开发和测试阶段的效率。这款工具不仅支持所有类型的HTTP请求方法，而且提供了强大的API测试工作管理和组织功能。

Postman的核心优势

Postman的优势主要体现在它的易用性、功能多样性和社区支持上。它的直观界面使得即使是API测试的新手也能迅速上手。同时，对于经验丰富的开发者而言，Postman强大的功能和丰富的插件生态系统足以满足各种复杂需求。此外，Postman还拥有庞大的用户社区，不断地推动着工具的发展和完善。

Postman的使用场景

Postman的适用场景非常广泛，它可以用于API开发过程中快速测试请求，也可以在API测试阶段进行深入的功能和性能测试。同时，Postman也经常被用于API文档的生成和分享。由于其灵活性，无论是独立开发者还是大型团队，都可以在软件开发生命周期的不同阶段使用Postman来提高工作效率。

2. 请求发送与配置

在API测试的整个生命周期中，发送和配置请求是核心环节。Postman作为一个强大的API测试工具，它简化了发送请求的过程，并允许用户通过图形界面轻松地构建和管理请求。在本章中，我们将深入探讨如何使用Postman来构建请求，包括请求方法的选择、URL的配置、请求头与认证信息的设置，以及如何利用环境变量和全局变量来增强请求的灵活性和复用性。此外，我们还将介绍高级配置，例如脚本预处理和响应处理，跨域资源共享（CORS）配置，以及安全和隐私设置。

2.1 请求的基本构建

2.1.1 请求方法的选取

在Postman中，支持多种HTTP请求方法，如GET、POST、PUT、DELETE等，它们在API测试中扮演着不同的角色：

• GET 请求主要用于从服务器获取数据。
• POST 请求用于向服务器提交数据，通常用于创建资源。
• PUT 请求用于更新服务器上的资源。
• DELETE 请求用于删除服务器上的资源。

2.1.2 构建和配置URL

URL（统一资源定位符）是API请求的重要组成部分。在Postman中，你需要按照API文档提供的规范来正确配置URL。通常，URL会包含基本的路径结构和动态参数：

https://api.example.com/resource/{id}

在这里， {id} 是一个参数占位符，你需要在发送请求时提供具体的值。在Postman中，你可以通过点击Params按钮来添加URL参数，并设置相应的值。

2.1.3 设置请求头与认证信息

HTTP请求头是包含有关请求的元数据的键值对，例如内容类型（Content-Type）、授权（Authorization）等。在Postman中，你可以通过Headers选项卡来添加请求头。认证信息通常包括API密钥、OAuth令牌等，它们可以通过Headers或Authorization选项卡来配置。

// 示例：设置请求头
Content-Type: application/json
Authorization: Bearer <token>

2.2 请求参数与数据体

2.2.1 参数类型与使用场景

在构建HTTP请求时，你可能需要设置参数，它们分为以下几种类型：

• Query Parameters：位于URL中，用于GET请求，或在POST请求中传递额外信息。
• Path Variables：作为URL路径的一部分，用于标识特定资源。
• Body Parameters：位于请求体中，通常用于POST或PUT请求。

2.2.2 构造数据体：表单、JSON、XML等格式

数据体是发送POST、PUT等请求时的重要组成部分，它包含了要发送的数据。Postman支持多种数据体格式：

• Form Data：适用于发送文件或键值对数据，常用于表单提交。
• x-www-form-urlencoded：用于URL编码格式的数据，适合发送简单的键值对数据。
• raw：允许你发送原始文本数据，支持多种类型，如JSON、XML、Text等。
• Binary：用于上传文件或发送二进制数据。

// 示例：发送JSON数据体
{
  "name": "John Doe",
  "email": "johndoe@example.com"
}

2.2.3 使用文件作为请求体的示例

在某些情况下，你可能需要发送文件作为请求体。Postman允许你上传文件，并根据文件类型选择合适的格式来发送。

2.3 高级请求配置

2.3.1 脚本预处理与响应处理

Postman允许你编写JavaScript脚本来处理请求的预处理（prerequest scripts）和响应（response scripts）。

• Prerequest Scripts：在发送请求之前运行，可以用来设置变量或执行验证。
• Response Scripts：在接收到响应后运行，可以用来检查响应内容或提取数据。

// 示例：Prerequest Script - 设置变量
pm.globals.set("token", "abcd1234");

2.3.2 跨域资源共享（CORS）配置

在API测试过程中，可能会遇到跨域资源共享（CORS）问题。Postman允许你配置代理来绕过CORS限制。

2.3.3 安全和隐私设置

为了测试API的安全性，你可能需要设置请求的敏感信息，如安全令牌或API密钥。在Postman中，你可以使用全局变量或环境变量来存储这些敏感信息，以保护它们不被暴露。

2.4 本章小结

本章详细介绍了Postman中请求发送与配置的相关内容。从基本的请求构建到高级配置，包括脚本处理和安全设置，覆盖了API测试中可能遇到的各种场景。掌握这些知识，可以帮助你更有效地使用Postman进行API测试工作。

graph LR
A[开始使用Postman] --> B[构建基本请求]
B --> C[选择请求方法]
C --> D[配置URL]
D --> E[设置请求头和认证信息]
E --> F[使用请求参数与数据体]
F --> G[高级请求配置]
G --> H[脚本预处理与响应处理]
H --> I[配置跨域资源共享（CORS）]
I --> J[安全和隐私设置]
J --> K[完成请求配置]

通过本章的学习，你应该已经能够熟练地使用Postman构建和发送API请求，并通过各种配置来适应不同的测试需求。接下来的章节将介绍如何管理和组织这些请求，以及如何利用环境变量来提升测试的灵活性。

3. 集合管理方法

3.1 集合的创建与管理

3.1.1 创建集合的基本步骤

集合（Collection）是Postman中用于组织API请求的核心概念。创建一个集合能够帮助我们更好地管理和复用API请求。创建集合的基本步骤如下：

1. 打开Postman应用。
2. 在侧边栏中点击“Collections”按钮，进入集合管理页面。
3. 点击“+”图标，选择“Create Collection”创建新集合。
4. 在弹出的对话框中输入集合的名称，并可选择性地添加描述和版本信息。
5. 点击“Save”保存新创建的集合。

以上步骤中创建集合的部分很简单。通常，在开发API时，我们不仅需要创建一个集合，还需要考虑集合的版本管理和结构清晰度。创建集合时提供版本信息可以更好地追踪API的更新与迭代。此外，在创建集合的过程中，我们也可以开始考虑如何将API请求分类，这将涉及到接下来的编辑操作。

3.1.2 编辑集合：增删改查操作

一旦集合创建完成后，我们可能需要对其进行编辑操作，以调整集合的结构或者添加新的请求。编辑集合包括增删改查等操作：

• 增加请求 ：在集合中点击“Add Request”按钮，添加新的请求项。
• 删除请求 ：右键点击要删除的请求项，选择“Delete”选项。
• 修改请求 ：双击请求项名称或请求体，即可进入编辑模式，修改相应内容。
• 查询请求 ：通过搜索框快速定位到特定的请求项。

这些操作都是基于Postman界面的交互，非常直观。编辑集合时，合理组织请求的顺序和结构将有助于提升效率。比如，根据业务逻辑或API的功能模块来组织请求顺序，或者使用文件夹（Folders）来分组相似请求，都是常用的管理手段。

3.1.3 集合的权限设置和分享

为了更好地进行团队协作和API测试，Postman允许对集合进行权限设置和分享。权限设置可以控制团队成员对集合的访问权限，分享功能则可以将集合分享给团队中的其他成员：

• 权限设置 ：点击集合旁的齿轮图标，进入设置页面，在“Visibility”选项中选择合适的权限级别。
• 分享集合 ：在集合的设置页面中，点击“Share Collection”按钮，选择要分享的成员或团队。

权限设置和分享功能对于团队协作是极其重要的。在设置权限时，可能需要考虑是否允许成员编辑集合，是否允许成员查看敏感信息等。分享时，确保选择正确的成员或团队，以便正确传达信息。当然，在Postman中，你还可以通过链接直接分享集合，方便快捷。

3.2 集合的高级功能

3.2.1 使用环境变量管理集合

环境变量（Environment Variables）是Postman中用于模拟不同环境下的数据的工具。在集合中使用环境变量可以极大地提高测试的灵活性和复用性。

• 环境变量的定义 ：在侧边栏中点击“Environments”按钮，新建或选择一个环境，然后定义所需的变量。
• 使用环境变量 ：在请求URL或请求体中使用 {{variable_name}} 的方式来引用变量。

例如，我们有一个API的请求URL是`https://example.com/api/{{version}}/endpoint`，在这里`{{version}}`就是环境变量。在测试时，我们可以为不同的环境（如开发、测试、生产）设置不同的版本号，通过切换环境即可实现对不同环境的API请求测试。

3.2.2 集合的测试与断言

为了确保API的行为符合预期，Postman提供了测试脚本的功能，允许我们在集合或请求中编写测试代码来验证API的行为。

• 编写测试脚本 ：在请求的“Tests”标签页中编写JavaScript代码，进行断言（Assertion）操作。
• 执行测试 ：通过发送请求或使用“Test”按钮单独执行测试脚本。

编写测试脚本时，应利用Postman内置的断言函数进行API响应的检查，例如`pm.test()`函数。以下是一个简单的测试示例：

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

pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

3.2.3 集合的版本控制与迭代

在API开发和测试过程中，版本控制是必不可少的。Postman允许对集合进行版本控制，便于跟踪API的变更和迭代。

• 创建版本 ：在集合设置中点击“Version”按钮，选择创建新的版本。
• 查看版本历史 ：在集合的“Versions”标签页中可以查看所有版本，并切换至不同版本查看详细信息。

版本控制不仅能够帮助我们追踪API的变更历史，还能支持并行开发，保证开发和测试的有序进行。在Postman中，每个版本都可以独立编辑和测试，但是必须通过发布新版本来共享更改。创建版本后，可以在其他团队成员之间共享，并在必要时切换回旧版本。

3.3 集合的自动化测试

3.3.1 集合运行器的使用

为了更好地利用Postman进行自动化测试，Postman提供了一个名为“Collection Runner”的工具。该工具允许我们运行整个集合或集合中的特定请求，配合环境变量的使用，可以实现复杂的测试场景。

• 使用集合运行器 ：在Postman中打开一个集合，点击集合名称旁的运行按钮，选择“Run in Collection Runner”。
• 配置运行设置 ：在Collection Runner界面中，可以选择运行模式，设置迭代次数，配置环境变量。

使用集合运行器时，可以实时观察到每个请求的执行结果，并且可以方便地查看详细的测试报告。在执行过程中，如果某个请求失败，可以选择跳过或停止后续请求的运行。这为API测试的稳定性和健壮性提供了保障。

3.3.2 数据文件驱动测试

当API需要处理大量数据时，手动输入数据将非常繁琐。Postman支持使用数据文件（如CSV、JSON、XML等格式）驱动测试，能够自动化地处理大量数据。

• 准备数据文件 ：创建数据文件，并按照Postman要求的格式准备好测试数据。
• 配置Collection Runner ：在Collection Runner界面中选择“Data File”，并上传准备好的数据文件。
• 运行测试 ：点击“Run Collection”运行测试，并观察结果。

数据文件驱动测试可以有效提高测试效率和测试覆盖范围。例如，如果API需要对成百上千的用户数据进行操作，我们可以通过一个用户信息的CSV文件，让Collection Runner逐条处理，从而实现批量测试。

3.3.3 连续集成中的Postman

对于持续集成（Continuous Integration, CI）流程，Postman提供了官方插件来集成Postman集合的运行结果。这允许在CI系统中自动执行Postman集合，并将测试结果整合到整个开发流程中。

• 配置CI插件 ：在CI工具（如Jenkins、Travis CI等）中安装并配置Postman CI插件。
• 执行测试 ：在CI流程中，使用Postman的命令行工具 newman 运行Postman集合。
• 集成结果 ：将Postman的测试结果整合到CI的反馈系统中。

通过集成Postman到CI流程中，开发团队可以在软件开发的每个提交阶段自动运行API测试，并及时得到测试反馈。这不仅加速了软件交付过程，还确保了API质量的持续监控。

通过第三章的内容，我们了解了如何高效地管理和使用Postman中的集合。集合的创建、编辑、分享和版本控制等功能极大地提升了API测试的组织性和协作性。而高级功能如环境变量、测试与断言、数据文件驱动测试等，进一步提高了测试的灵活性和覆盖率。最后，结合CI流程的自动化测试，将Postman集合的运行结果集成到持续集成系统中，为团队协作和软件交付提供了强大的支持。

4. 环境变量与脚本编写

在软件测试和API开发中，环境变量和脚本是实现高度可配置、可重复测试的关键。Postman通过其内置的环境变量和脚本功能，极大地简化了测试过程，提高了工作效率。本章将深入探讨如何在Postman中使用环境变量，以及如何编写预请求脚本和测试脚本，从而实现自动化测试流程。

4.1 环境变量的使用

环境变量允许用户在不同的测试环境中快速切换，无需更改代码本身。这使得测试人员能够轻松地在本地、开发、测试和生产等环境中进行API测试，确保API在各种环境下均能正常工作。

4.1.1 环境变量的定义与使用场景

在Postman中，可以创建多个环境，每个环境都有其自己的环境变量集。例如，你可能有一个开发环境和一个生产环境，它们使用不同的数据库连接字符串。通过环境变量，你可以在发送请求时引用这些值，而不需要硬编码它们。

步骤一：定义环境变量 1. 打开Postman，选择“Environments”（环境）选项卡。 2. 点击“Add”（添加）创建一个新的环境。 3. 在弹出的环境中，输入环境名称，例如“Development”。 4. 在“Initial Value”（初始值）列中定义环境变量，如 {{url}} ，并设置其值为你的开发环境API地址。 5. 点击“Save”（保存）来保存环境。

步骤二：使用环境变量 在请求中，使用双大括号 {{variable_name}} 的格式来引用环境变量。例如，在URL中使用 {{url}}/users 来代替硬编码的API地址。

4.1.2 切换环境与环境变量的作用域

环境变量的作用域限定于它们被定义的环境。在Postman中，可以轻松地在不同环境间切换。

1. 在Postman的主窗口的右上角，找到环境选择器。
2. 点击下拉菜单，你会看到所有已定义的环境。
3. 选择你想要切换到的环境，Postman会自动应用该环境中定义的所有变量。

4.1.3 环境变量的动态创建与管理

环境变量可以在运行时动态创建和更新，这提供了更大的灵活性。

1. 使用预请求脚本（Pre-request Script）来动态添加或修改环境变量。例如：

// 在预请求脚本中动态添加环境变量
pm.environment.set("dynamicVariable", "newValue");

1. 通过环境选择器旁边的“Manage Environments”（管理环境）按钮，可以对已有的环境进行编辑、删除或克隆操作。

4.2 预请求脚本与测试脚本

预请求脚本（Pre-request Script）和测试脚本（Tests Script）是Postman中用于增强API测试能力的脚本功能。预请求脚本在发送请求前执行，而测试脚本在接收到响应后执行。

4.2.1 预请求脚本的作用与编写方法

预请求脚本主要用于在发送请求之前设置请求头、参数或其他逻辑操作。这样可以确保发送的请求是完全配置好的，无需在请求构建器中手动添加。

1. 打开一个请求，切换到“Pre-request Script”标签页。
2. 在此区域中，编写JavaScript代码，例如添加默认授权头：

// 添加默认授权头
if (pm.request.headers.get("Authorization") == null) {
    pm.request.headers.add({
        key: "Authorization",
        value: "Bearer {{token}}"
    });
}

4.2.2 测试脚本的编写：断言、变量和日志记录

测试脚本用于验证API响应是否符合预期。它支持使用Chai断言库和其他Postman脚本API来执行各种检查。

1. 在请求的“Tests”标签页中编写测试脚本。
2. 添加断言来检查响应的状态码、响应时间、JSON路径等：

// 断言响应状态码为200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

// 检查响应体中是否存在特定字段
pm.test("Body matches string", function () {
    pm.expect(pm.response.text()).to.include("string_to_search");
});

// 日志记录
pm.log("执行了测试脚本");

4.2.3 脚本中的错误处理和调试技巧

在编写脚本时，错误处理和调试是提高代码质量和可靠性的关键。Postman提供了错误处理和日志记录功能。

1. 使用try-catch结构来捕获脚本中可能出现的错误：

try {
    // 尝试执行某些操作
} catch (error) {
    // 在这里处理错误
}

1. 使用 console.log 来输出调试信息，这些信息会出现在Postman的控制台中，有助于定位问题。

通过这些技巧，我们可以在Postman中有效地利用环境变量和脚本来提高测试的灵活性和自动化水平。

5. Postman的进阶应用与集成

5.1 API文档的自动生成与分享

Postman提供的文档自动生成功能极大地简化了API的文档化过程。开发者和测试人员可以轻松地从Postman集合生成详细的API文档，并与团队成员或利益相关者共享。

5.1.1 从集合生成API文档的步骤

1. 选择集合 ：打开Postman，选择一个或多个你想要文档化的集合。
2. 生成文档 ：点击界面右上角的“View Documentation”按钮。
3. 编辑和自定义 ：自动生成的文档可以进一步编辑和格式化。Postman提供了各种设置选项来定制API文档的外观和内容。

5.1.2 API文档的查看、编辑与分享

• 查看文档 ：在浏览器中查看生成的文档。
• 编辑文档 ：可以对文档进行在线编辑，如修改描述、排序等。
• 分享文档 ：生成的文档可以被分享到不同的平台或嵌入到其他系统中。点击“Share Document”按钮并选择分享方式，例如，生成公开链接或限制访问权限。

5.2 API测试的监控能力

Postman不仅用于创建和发送API请求，它也支持API测试的监控和持续监控，以确保API的稳定性和性能。

5.2.1 设置测试监控与通知

• 监控设置 ：在Postman中创建监控任务，设置请求的频率和时间间隔。
• 通知 ：监控任务可以配置为在API性能下降或失败时发送通知，通过电子邮件或其他集成平台。

5.2.2 监控报告的分析与导出

• 报告分析 ：监控历史和性能数据可以用来分析API的运行趋势。
• 导出报告 ：可以将监控数据导出为CSV或JSON格式，用于进一步的分析或报告。

5.3 模拟服务器功能

为了测试API与前端或其他服务的交互，Postman允许创建模拟服务器。

5.3.1 创建模拟服务器

• 新建服务器 ：在Postman中创建一个新的模拟服务器实例。
• 配置服务器 ：设置请求匹配规则、响应体、状态码和延迟等。

5.3.2 模拟服务器的配置与应用

• 配置规则 ：设置精确匹配或模糊匹配规则，以确保请求正确地被模拟服务器捕获。
• 使用模拟服务器 ：将API调用指向模拟服务器以测试不同场景下的应用行为。

5.4 Postman与其他工具的集成

Postman支持与其他开发和测试工具的集成，例如持续集成/持续部署（CI/CD）工具，以及项目管理工具如Jira和Slack。

5.4.1 集成持续集成工具（CI）

• 配置CI插件 ：在CI工具（如Jenkins、Travis CI等）中安装Postman插件。
• 运行测试集 ：在CI流程中添加Postman集合运行步骤，以自动化API测试。

5.4.2 Postman与Jira、Slack的集成示例

• 与Jira集成 ：当Postman测试失败时，自动在Jira中创建问题。
• 与Slack集成 ：将Postman通知直接发送到指定的Slack频道。

5.5 Postman Native App与中文资源

Postman提供了一个原生应用（Postman Native App），该应用为用户提供了一个桌面环境，以离线使用Postman的部分功能。

5.5.1 Postman Native App的安装与配置

• 下载安装 ：访问Postman官网下载Postman Native App。
• 配置与使用 ：安装完毕后配置环境变量，导入API集合。

5.5.2 中文版Postman的资源和帮助信息

• 资源下载 ：Postman为中文用户提供本地化资源下载。
• 帮助中心 ：访问Postman中文帮助中心，获取关于使用、配置和故障排除的资源。

通过本章的介绍，您应该对Postman在API测试中的高级应用和集成有了更深层次的了解。利用这些高级功能，您可以更高效地完成API测试任务，确保API的稳定性和性能，同时也能够有效地管理和分享API文档，与团队成员协作。

本文还有配套的精品资源，点击获取

简介：Postman是一个广受欢迎的API开发和测试工具，提供了包括请求发送、集合管理、环境变量设置、预请求与测试脚本编写、文档生成、团队协作分享、API监控、模拟服务器和集成其他开发工具等核心功能。该压缩包包含了帮助中文用户理解和使用Postman的所有资源，包括中文语言包、用户手册和教程等，旨在为中国用户提供语言支持和更好的使用体验。

本文还有配套的精品资源，点击获取