API测试:Postman入门指南 | RST Software

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

你是否曾听说过Postman,却不清楚它是什么以及如何使用?如果你正在寻找答案,那么这篇文章将为你提供一份详细的Postman入门指南,帮助你轻松上手API测试


安装与基本信息

Postman是一款功能强大的API测试工具,其最新版本可以从以下网址下载:https://www.getpostman.com。根据你的操作系统选择合适的版本并完成安装。安装后,建议创建一个Postman账户,这样你的所有请求都可以同步到云端,方便随时随地访问。

虽然Postman Pro提供了更多高级功能,例如团队协作和虚拟机测试,但对于日常工作来说,免费版本已经足够使用。


创建开发者账户

要开始使用Postman测试API,首先需要创建一个开发者账户并获取API密钥。具体步骤如下:

  1. 打开Postman页面,点击“请求API密钥”。
  2. 按照页面提示填写必要信息并提交。
  3. 你将收到一封包含API密钥的电子邮件。

在获取密钥后,建议阅读目标API的文档。例如,本文使用的测试API是《纽约时报》的Books API,其文档地址为:http://developer.nytimes.com/books_api.json#/Documentation/GET/lists.{format}


使用Postman发送第一个GET请求

完成账户创建后,你可以尝试在Postman中发送第一个GET请求。以下是详细步骤:

  1. 登录Postman后,点击左侧的“新建请求”按钮。

  2. 为请求命名,例如“关于作者的问题”。

  3. 创建一个集合(Collection)来存储该请求,例如“NYT API”。

  4. 根据API文档,复制API的基本地址(Base URI),并将其粘贴到Postman的“请求URL”字段中。

  5. 将API版本更新为最新版本(例如v3)。

  6. 根据文档,构建具体的请求路径。例如,查询畅销书历史数据的路径为:

    http://api.nytimes.com/svc/books/v3/lists/best-sellers/history.json?author=stephen%20king
  7. 在“Headers”选项卡中添加API密钥:

    • 键(Key):api-key
    • 值(Value):你收到的API密钥

完成以上步骤后,点击“发送”按钮。如果返回状态码为200,并且响应中包含关于Stephen King的书籍信息,说明请求成功。


自动化测试脚本

除了手动发送请求,Postman还支持通过JavaScript编写测试脚本,自动验证API响应。以下是一个简单的测试案例:

  1. 在“Tests”选项卡中输入以下代码,用于检查响应状态码是否为200:

    pm.test("Status code is 200", function () {
       pm.response.to.have.status(200);
    });
  2. 发送请求后,切换到“测试结果”选项卡,查看测试是否通过。

验证响应内容

我们可以进一步验证响应中是否包含特定数据。例如,检查返回的书籍信息是否与Stephen King相关。以下是测试代码:

pm.test("Response contains Stephen King", function () {
    pm.expect(pm.response.text()).to.include("Stephen King");
});

执行测试后,若响应中包含Stephen King的书籍信息,则测试通过。


结论

Postman不仅是一个简单的自动化测试。通过编写合理的测试脚本,你可以显著提高测试效率,减少人为错误。在回归测试中,自动化测试的优势尤为明显。无论是初学者还是专业开发者,Postman都是一款不可或缺的工具。


原文链接: https://www.rst.software/blog/api-testing-postman-for-beginners