掌握Postman进行API测试:全面指南

作者:API传播员 · 2025-12-26 · 阅读时间:5分钟

Postman 是一个功能强大的 创建优质 API。Postman 的优势在于其集合功能和支持多种测试环境的能力,同时它也是一个用户友好的工具,可以显著优化测试执行时间。无论是桌面版还是基于 Web 的 Postman 工具,都支持手动API 测试的自动化。


为什么需要自动化 API 测试?

在软件开发过程中,测试是确保软件质量的关键步骤。无论 自动化 API 测试,可以快速发现错误,并在开发过程中无缝添加新功能。这种方式不仅提高了测试效率,还能确保测试用例在整个开发周期中持续运行。


Postman 实现 API 测试自动化的步骤

在使用 Postman 编写 API 测试时,可以按照以下步骤操作:

  1. 手动测试 API。
  2. 理解 API 返回的响应。
  3. 编写自动化测试。
  4. 对 API 的每个端点重复上述步骤。

手动测试 API

  1. 打开 Postman 并切换到工作区(例如:我的工作区)。
  2. 创建一个测试集合(例如:智能手机测试演示集合)。

Postman 界面示例如下:

Postman 界面

  1. 测试 API 的 CREATE 端点。CREATE 请求是一个 POST 请求,需要包含 JSON 格式的正文,例如 idtitledescription 等字段。
  2. 打开侧边栏中的“创建智能手机”请求,并单击它。
  3. 在请求中提供必填字段的详细信息,然后按下 Enter 键,验证响应正文中的成功响应。

以下是请求有效载荷和响应的示例:

请求有效载荷

响应示例


理解 API 返回的响应

  • 我们可以看到状态代码为 200 OK 的响应以及 JSON 格式的正文。
  • 确认这是端点的预期响应后,可以继续进行下一步操作。

编写自动化测试

Postman 提供了一个基于 Node.js 的运行时环境,允许用户使用 JavaScript 编写脚本。在 Postman 中,可以在以下两个事件期间添加脚本:

  • 预请求脚本:在发送请求之前执行,编写于“预请求脚本”选项卡。
  • 测试脚本:在收到请求响应后执行,编写于“测试”选项卡。

以下是 Postman 中“测试”选项卡的示例:

测试选项卡

所有 Postman 测试套件或场景都以 test() 函数开始,该函数通过 Postman 提供的全局对象 pm(Postman 的缩写)公开。test() 方法接受两个参数:

  1. 测试描述(例如:“状态代码为 200”)。
  2. 回调函数,用于对特定请求的响应进行断言或验证。

以下是一个简单的断言示例,用于检查响应状态码是否为 200 OK

状态码断言


运行测试

为了运行测试,再次向端点发送请求。这一次,当 Postman 收到响应时,将自动运行测试。以下是测试通过的示例:

测试通过示例

为了验证测试的可靠性,可以故意使测试失败。例如,在 URL 中添加一个拼写错误(如 /a),然后重新发送请求。此时,测试将失败:

测试失败示例

删除拼写错误后,测试将再次通过。


添加更多测试用例

  1. 检查响应体是否包含特定属性

    例如,验证响应体中是否包含 id 属性:

    验证 id 属性

  2. 验证 JSON 格式和特定字段

    检查响应体中是否包含 jsontitle 属性:

    验证 JSON 和 title

  3. 测试 GET 请求

    为 GET 请求提供 id 参数,并验证响应内容。例如,检查状态码是否为 200 OK

    GET 请求状态码验证

  4. 验证响应体是否为 JSON 格式

    添加以下查询以检查响应体格式:

    验证 JSON 格式

  5. 验证响应体中的特定值

    例如,检查响应体中是否包含 id=1description 属性值为 Add

    验证特定值


结论

通过本文,我们展示了如何利用 Postman 手动编写API 的质量并最小化缺陷风险。自动化测试不仅可以提高测试效率,还能帮助开发者快速发现问题并优化 API 的整体表现。

原文链接: https://www.winwire.com/blog/postman-api-testing/