Postman入门指南:API测试初学者教程 - Medium

作者:API传播员 · 2025-12-26 · 阅读时间:5分钟
Postman入门指南:API测试初学者教程详细介绍了如何使用Postman工具进行API测试,包括安装、创建集合、发送GET和POST请求,以及使用路径参数和查询参数过滤数据。通过实战示例,帮助初学者快速掌握API测试技巧,提升开发效率。

Postman入门指南:API测试初学者教程

Postman 是一款广受开发者欢迎的 团队协作效率。


Postman 的核心功能

  • 简化 API 交互

    Postman 提供了直观的用户界面,支持发送 HTTP 请求(如 GET、POST)并查看响应结果。

  • 高效的 API 测试

    通过发送各种请求并分析响应,快速发现和定位问题。

  • 优化工作流程

    在一个平台上完成 API 的设计、构建、测试、文档化和协作。

  • 团队协作支持

    轻松共享请求、环境配置和文档,提升团队协作效率。

  • 多功能扩展

    支持模拟服务器、代码生成以及多种身份验证方式。


什么是 API?

API(应用程序编程接口)是不同软件程序之间的桥梁,帮助它们相互通信和共享数据。可以将其类比为餐馆的菜单:菜单告诉你可以点哪些菜以及如何点餐。同样,API 告诉一个程序如何向另一个程序请求数据或执行任务。


如何开始使用 Postman?

安装 Postman

您可以选择在本地安装 Postman 应用程序,或者直接使用其网页版。如果您需要频繁进行测试,建议安装本地版本。

安装完成后,您可以选择创建或登录账户,也可以跳过登录直接使用应用程序。


创建第一个集合和请求

创建集合

在 Postman 左侧导航栏中,点击“创建集合”按钮,或者使用“+”图标创建一个新的集合。集合是用于组织和保存请求的容器。建议为每个测试项目创建一个集合,并根据需求将请求分组到不同的文件夹中。

创建子文件夹

在集合中,您可以通过点击集合右侧的“三点”图标,选择“添加文件夹”来创建子文件夹,用于对 API 进行分类(例如 Auth、Stripe、Rest 等)。

添加请求

在文件夹下,点击“添加请求”按钮,或者通过文件夹右侧的“三点”图标选择“添加请求”。为请求命名并设置请求方法(如 GET、POST 等)。


实战:使用简单书籍 API 测试

简单书籍 API 信息

创建 GET 请求

  1. 在“Simple Books API”文件夹中创建一个新请求,命名为“GET List of Books”。
  2. 设置请求方法为 GET
  3. 将基本 URL https://simple-books-api.glitch.me 粘贴到请求 URL 中。
  4. 点击发送按钮,查看响应结果。

复制和修改请求

  • 复制现有的“GET List of Books”请求,命名为“GET a Book”。
  • 在基本 URL 后添加路径参数,例如 /books/:bookId,以获取指定书籍的信息。

使用查询参数过滤数据

  • 为了获取特定类型的书籍(如小说),可以使用查询参数。
  • 在请求的“参数”选项卡中,添加键值对:type=fiction
  • 发送请求后,您将收到仅包含小说书籍的列表。

使用 POST 方法发送数据

创建 POST 请求

  1. 创建一个新请求,命名为“用户登录”。

  2. 设置请求方法为 POST

  3. 在请求体中选择“原始”模式,并将数据类型设置为 JSON

  4. 提供电子邮件和密码的 JSON 格式数据,例如:

    {
       "email": "example@example.com",
       "password": "yourpassword"
    }
  5. 发送请求后,查看登录成功的响应消息。


响应结果的查看与保存

在 Postman 中,您可以查看以下响应信息:

  • 状态码:表示请求的处理结果。
  • 响应时间:显示服务器处理请求所需的时间。
  • 响应大小:显示返回数据的大小。

此外,您可以切换响应的显示模式(如 Pretty、Raw、Preview),并将响应另存为示例或文件。

完成测试后,记得保存请求。未保存的更改会以橙色圆点提示。


总结

通过本文,您已经了解了如何使用 Postman 创建集合、发送 GET 和 POST 请求,以及如何使用路径参数和查询参数过滤数据。Postman 是一款功能强大的工具,能够极大地提升 API 测试的效率和准确性。希望您能通过实践熟练掌握 Postman 的使用技巧,为开发工作带来更多便利。

原文链接: https://medium.com/@sumudithalanz/postman-101-a-beginners-guide-to-api-testing-676f799286e3