3步搞定！2024最火Postman API测试技巧，新手也能轻松上手！

API 调试利器：Postman 使用指南

Postman 是一款强大的 API 测试和调试工具，被广泛应用于软件开发、测试和 API 文档生成等领域。它提供了一个图形化界面，允许开发者发送各种 HTTP 请求，并查看服务器的响应，极大地简化了 API 开发和调试的流程。

Postman 的优势

• 易于使用： Postman 提供友好的图形化界面，即使没有编程经验也能快速上手。
• 支持多种 HTTP 方法： 支持 GET, POST, PUT, DELETE, PATCH 等所有常用的 HTTP 请求方法。
• 强大的请求构造能力： 可以灵活地自定义请求头、请求体、查询参数等。
• 丰富的响应查看工具： 可以格式化地显示 JSON, XML, HTML 等响应内容，方便分析。
• 支持环境变量和集合： 可以使用环境变量来管理不同环境的配置，并通过集合来组织和分享 API 请求。
• 协作能力： 允许团队成员共享集合和环境，方便团队协作开发和测试 API。
• 自动化测试： 可以编写脚本来自动化测试 API，并生成测试报告。
• 免费使用： 提供免费版本，满足大部分用户的需求。

Postman 的安装和启动

1. 下载 Postman: 访问 Postman 官网 https://www.postman.com/downloads/ ，根据你的操作系统（Windows、macOS 或 Linux）选择对应的版本进行下载。请确保下载最新稳定版本，以获得最佳性能和最新的功能支持。同时，官网也提供了Postman的Web版本，你可以在浏览器中直接使用，无需下载安装客户端，但功能上可能存在一定的限制。
2. 安装 Postman: 下载完成后，双击安装包，按照屏幕上的指示完成安装过程。在Windows系统中，可能需要管理员权限才能成功安装。在macOS系统中，将Postman图标拖动到"Applications"文件夹即可完成安装。安装完成后，Postman会自动启动，或者你可以在应用程序列表中找到Postman并手动启动。
3. 启动 Postman: 安装完成后，启动 Postman 应用程序。首次启动时，你可能需要注册一个 Postman 账号。你可以使用 Google 账号快速注册，或者使用邮箱地址创建账号。注册账号可以让你在不同的设备上同步你的 Postman 数据，包括集合、环境和历史记录。如果你不想注册账号，可以选择跳过登录步骤，但这意味着你的数据将仅存储在本地。请注意，Postman 账号是免费的，但Postman也提供了付费的专业版和企业版，拥有更高级的功能和更大的团队协作空间。启动完成后，你将看到 Postman 的主界面，可以开始创建和发送 API 请求了。

使用 Postman 发送您的首个 API 请求

Postman 是一款强大的 API 测试工具，以下步骤将引导您发送一个简单的 GET 请求，并解读返回结果，助您快速入门。

1. 输入请求 URL: 在 Postman 地址栏（也称为 URL 栏）中，精确输入您要访问的 API 端点。例如，您可以使用一个公开的 API，如 https://placeholder.typicode.com/posts/1 来获取 ID 为 1 的文章。确保 URL 拼写正确，包括协议 (https://) 和任何必要的路径参数。
2. 选择请求方法: Postman 提供了多种 HTTP 请求方法，如 GET、POST、PUT、DELETE 等。在地址栏左侧的下拉菜单中，选择 GET 方法。GET 方法用于从服务器获取数据，是最常用的请求类型之一。
3. 发送请求: 点击蓝色的 "Send" 按钮，Postman 将构造并发送您的 HTTP 请求到指定的服务器。请确保您的计算机已连接到互联网，并且服务器处于运行状态。
4. 查看响应: 请求发送后，下方的响应区域将显示服务器返回的信息。这包括：
   • 状态码: 一个三位数的数字，表示请求的结果。例如， 200 OK 表示请求成功， 404 Not Found 表示请求的资源未找到， 500 Internal Server Error 表示服务器内部错误。理解状态码对于调试 API 问题至关重要。
   • 响应头: 包含关于响应的元数据，例如 Content-Type （指示响应体的类型，如 JSON 或 XML）、 Content-Length （响应体的大小）和 Cache-Control （指示浏览器如何缓存响应）。
   • 响应体: 包含服务器返回的实际数据。通常以 JSON 或 XML 格式返回。例如，如果请求 https://placeholder.typicode.com/posts/1 ，响应体将是一个 JSON 对象，包含文章的 ID、标题、内容等信息。

   仔细检查响应体的内容，确认其符合预期。如果遇到问题，可以检查请求 URL 是否正确，或者查看服务器端的日志以获取更多信息。

构建复杂的请求

Postman 不仅仅可以发送简单的 GET 请求，还可以构建复杂的请求，例如带有请求头、请求体和查询参数的请求。

请求头 (Headers)

请求头用于向服务器传递附加信息，例如内容类型、认证信息等。

1. 点击 Postman 界面中的 "Headers" 标签。
2. 在 "Key" 列中输入请求头的名称，例如 "Content-Type"。
3. 在 "Value" 列中输入请求头的值，例如 "application/"。
4. 点击复选框启用该请求头。

请求体 (Body)

请求体用于向服务器发送数据，例如 POST 请求中的表单数据或 JSON 数据。

1. 点击 Postman 界面中的 "Body" 标签。
2. 选择请求体的类型，例如 "raw" 或 "form-data"。
3. 如果选择 "raw"，可以选择请求内容的格式，例如 "JSON"、"XML"、"Text" 等。

4. 在文本框中输入请求体的内容。 例如，如果选择 "JSON" 格式，可以输入：

   { "name": "John Doe", "email": "[email protected]" }

5. 如果选择 "form-data"，可以添加键值对来模拟表单数据。

查询参数 (Params)

查询参数是一种常用的数据传递方式，允许客户端通过 URL 向服务器发送附加信息。这些参数通常以键值对的形式出现，附加在 URL 的末尾，通过问号 `?` 分隔基本 URL 和参数部分。例如，在 https://api.example.com/users?page=1&limit=10 这个URL中，`page` 和 `limit` 就是查询参数，分别设置了页码和每页显示的记录数量。 使用查询参数可以实现分页、排序、过滤等功能，使得API可以根据客户端的需求返回不同的数据。

在 Postman 中，可以便捷地管理和设置查询参数，无需手动构建复杂的 URL。

1. 打开 Params 面板: 在 Postman 界面中，找到并点击 URL 输入框下方的 "Params" 标签。这将展开一个表格，用于输入和管理查询参数。
2. 定义参数键 (Key): 在 "Key" 列中，输入您要传递的参数名称。例如，如果您想指定返回结果的页码，可以输入 "page"。键名是区分大小写的，应当与API文档中规定的名称一致。
3. 设置参数值 (Value): 在 "Value" 列中，输入与 "Key" 对应的参数值。对于 "page" 参数，您可以输入 "1" 来请求第一页的数据。参数值通常是字符串，但Postman 会自动处理编码，使其符合 URL 规范。
4. 启用/禁用参数: 每个参数旁边都有一个复选框。点击该复选框可以启用或禁用该参数。只有启用的参数才会包含在最终的 URL 中。这允许您轻松地添加或删除参数，而无需完全删除它们。
5. URL 自动生成: Postman 会根据您在 "Params" 表格中输入的键值对，自动构建包含查询参数的完整 URL。您可以在 URL 输入框中实时看到更新后的 URL。 如果有多个查询参数，Postman 会使用 `&` 符号将它们连接起来。

使用环境变量

环境变量是Postman中一项强大的功能，它允许开发者在不同的运行环境（如开发、测试、生产环境）中使用不同的配置参数，而无需修改请求本身。这种方法极大地提高了项目的可移植性和可维护性，并简化了部署流程。

1. 在Postman界面的右上角，找到并点击 "Environment quick look" 图标（通常以眼睛的形状表示）。这个图标用于快速访问和管理已定义的环境变量。
2. 在弹出的 "Manage Environments" 窗口中，点击 "Add" 按钮，创建一个新的环境配置。这将允许你为特定环境定义一组独特的变量。
3. 为新的环境指定一个具有描述性的名称，例如 "Development"（开发环境）、"Staging"（预发布环境）或 "Production"（生产环境）。清晰的环境命名有助于团队成员理解配置的用途。
4. 在 "Variables" 表格中，逐行添加需要使用的环境变量。每个变量都需要一个名称和一个值。例如，可以添加 "API_URL" 变量来存储API的根URL，以及 "API_KEY" 变量来存储用于身份验证的API密钥。变量名应具有描述性，并且遵循一致的命名规范。
5. 在每个变量的 "Current Value" 列中，输入该变量在当前环境下的实际值。例如，对于 "API_URL" 变量，在 "Development" 环境中可以输入 "https://dev.api.example.com"，而在 "Production" 环境中则输入 "https://api.example.com"。 对于 "API_KEY" 变量，输入与环境相对应的API密钥，例如 "abcdef123456" 或 "zyxwvu987654"。 也可以设置 "Initial Value", 它和 "Current Value" 相似，当Postman Team同步共享环境时，"Current Value"不会同步共享，保证密钥的安全性。
6. 完成变量的添加和赋值后，点击 "Save" 按钮保存当前环境配置。确保定期保存环境，以防止数据丢失。

现在，你可以在Postman请求中使用定义好的环境变量。为了在请求中使用变量，只需将变量名用双花括号括起来，例如 {{API_URL}}/users 。当Postman发送请求时，它会自动查找并替换环境变量的值。这使得你可以轻松地在不同的环境之间切换，而无需修改请求的URL或其他参数。还可以使用点号(`.`)和索引来访问环境变量中的嵌套对象和数组，例如 `{{API_RESPONSE.data[0].name}}`。环境变量还可以在请求头、请求体、测试脚本等任何支持字符串的地方使用，从而提供极大的灵活性。

使用集合 (Collections)

集合在 Postman 中扮演着至关重要的角色，用于高效地组织、管理和分享 API 请求。它们允许你将相关的 API 调用分组在一起，形成一个结构化的目录，从而简化 API 开发和测试流程。

1. 点击 Postman 界面左侧的 "Collections" 标签。这是访问和管理现有集合以及创建新集合的入口点。
2. 点击 "New Collection" 按钮创建一个新的集合。 这将打开一个对话框，允许你定义集合的基本属性。 Postman 允许你创建空白集合或从模板导入集合。
3. 输入集合的名称，例如 "User API"。 选择一个有意义且描述性的名称，以便于识别集合的目的。 例如， "订单管理 API"、"支付网关 API" 等。 你也可以添加描述来提供关于集合的更多上下文信息，例如集合包含的 API 功能以及使用场景。
4. 可以将 API 请求添加到集合中。 你可以通过以下几种方式将 API 请求添加到集合中：
   • 从历史记录中添加：Postman 会记录你发送过的所有请求，你可以从中选择并添加到集合中。
   • 导入 API 请求：你可以从文件 (例如， Postman 集合格式、 OpenAPI 规范) 导入 API 请求。
   • 手动创建 API 请求： 你可以手动输入 API 端点、请求方法、请求头、请求体等信息来创建一个新的 API 请求。
   添加请求后，你可以组织它们到文件夹中，以便更好地管理集合。
5. 可以导出集合并分享给其他团队成员。 Postman 允许你将集合导出为 JSON 文件，然后可以通过电子邮件、共享驱动器或其他协作工具与他人分享。 导出的集合包含了所有 API 请求的详细信息，包括 URL、请求方法、请求头、请求体、测试脚本和变量。 团队成员可以通过导入集合来快速设置他们的 Postman 环境，并开始使用 API。 导出功能也支持导出环境变量，允许团队成员共享完整的 API 开发和测试环境。 你还可以选择分享集合的链接，允许其他人查看集合的文档。

编写测试脚本 (Tests)

Postman 允许你编写 JavaScript 脚本，针对 API 响应进行自动化测试，验证其正确性和可靠性。 这些脚本可用于检查各种方面，包括状态码、响应头、响应体以及其他自定义条件。

1. 点击 Postman 界面中的 "Tests" 标签。 此标签位于请求构建器的下方，允许你访问脚本编辑器。

2. 编写 JavaScript 脚本来测试响应的各个方面，包括状态码、响应头和响应体。 使用 Postman 提供的 pm 对象访问响应数据和执行断言。

   例如，以下脚本测试响应状态码是否为 200 (OK)：

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

   此脚本使用 pm.test() 函数定义一个测试，并使用 pm.response.to.have.status(200) 断言验证状态码是否为 200。

   以下脚本测试响应体是否包含 "users" 字段：

   javascript pm.test("Response body should have users property", function () { pm.expect(pm.response.()).to.have.property('users'); });

   此脚本使用 pm.expect() 函数创建一个期望，并使用 .to.have.property('users') 断言验证响应体 (解析为 JSON 对象后) 是否包含名为 "users" 的属性。 pm.response.() 用于将响应体解析为 JSON 对象以便进行属性访问。

   除了状态码和响应体，你还可以测试响应头，例如 Content-Type：

   javascript pm.test("Content-Type is application/", function () { pm.response.to.have.header("Content-Type", "application/; charset=utf-8"); });

   此脚本使用 pm.response.to.have.header() 断言验证 Content-Type 响应头是否为 "application/"。 确保检查了正确的字符集 (charset)，以获得更精确的匹配。

   你还可以使用环境变量和全局变量，使测试脚本更具动态性：

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

   在这个例子中， {{responseTime}} 是一个环境变量，代表允许的最大响应时间。 pm.environment.get("responseTime") 用于从当前环境中检索该变量的值。

3. 运行请求时，Postman 会自动执行 "Tests" 标签中编写的测试脚本，并在 "Test Results" 标签中显示测试结果。 测试结果会显示每个测试的通过或失败状态，以及任何错误消息，帮助你快速诊断 API 的问题。

高级功能

Postman 还提供了许多高级功能，例如：

• Mock Servers: 模拟 API 服务器，方便前端开发和测试。
• Monitors: 定期运行集合中的请求，监控 API 的性能和可用性。
• Collaboration: 团队协作，共享集合和环境。
• API Documentation: 自动生成 API 文档。

Postman 是一个功能强大且易于使用的 API 测试工具，可以极大地提高 API 开发和调试的效率。 掌握 Postman 的基本使用方法，可以让你更好地理解和使用 API，并开发出高质量的应用程序。