初学者：Postman 入门教程

原创已于 2022-10-23 18:29:06 修改 · 2.5k 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#深入学习postman #postman入门 #postman教程 #postman高级教程

于 2018-12-17 22:26:21 首次发布

java系列专栏收录该内容

11 篇文章

订阅专栏

一、引言

用 Postman 调试 API 接口非常方便，对于不同种类的工程师都有适用的场景。如果你是后台工程师，在你开发接口后，你可以用 Postman 调试接口；如果你是前端工程师，在拿到后台工程师给你的接口文档后，不要急着写代码，你可以先用 Postman 把接口调通，再写代码对接接口，可以避免因接口本身的错误而导致的其他问题；如果你是测试工程师，当后台工程师已经开发好了接口，而前端工程师还在对接接口时，你可以先按照你的测试用例用 Postman 来测试接口，提前发现一些接口的 bug，而不用浪费时间等前端工程师把所有的页面对接完才能测试。

二、Postman下载

Postman 有原生应用程序和chrome插件两种不同的使用方式。你可以在官网下载不同操作系统的Postman 原生应用程序（Download Postman | Get Started for Free），由于有的读者因为网络原因下载很慢或者下载不了，所以我提前把各个系统的最新版本下载下来放到百度网盘。有需要的读者可以关注微信公众号“毛惜时”，后台回复“postman”即可获取下载链接。不建议你使用 chrome 浏览器插件版的 Postman，因为插件版的功能远没有原生应用程序强大，并且官方已经停止了对Postman 插件版的更新，所以这里不介绍插件版的下载。

三、入门例子

1、发送第一个请求

Postman 官方提供了一个可供测试的特殊接口（https://postman-echo.com/get?test=123），该接口会将请求参数在响应中返回。如下图所示：我提交一个test的参数，响应中也会返回该参数。

单击"send"按钮发送你的请求。注意来自服务器的JSON数据响应。

（温馨提示：点击图片可放大）

到现在为止我们的第一个请求成功了，服务器收到了我们的请求，并且将我们带过去的参数响应给了我们。可以看出使用 Postman 请求接口非常简单，填好请求地址、请求参数，然后选择请求方法，点击 send 按钮，服务端返回数据后，我们就完成了一次HTTP请求，也完成了接口的调用。

2、保存请求到收藏夹（Collections）

Postman 中发送的每个请求都会显示在侧栏的“ 历史记录”选项卡下。在小规模上，通过历史部分重用请求很方便。但是，随着接口的增加，在历史记录中查找特定请求可能会非常耗时。你可以将所有请求保存为一组收藏夹中，以便于访问，而无需梳理历史记录部分。

（温馨提示：点击图片可放大）

点击上图中的"save"按钮可以将请求保存到一个收藏夹，方便下次使用。

3、查看请求头

（温馨提示：点击图片可放大）

4、查看请求体

Postman 允许发送几乎任何类型的 HTTP 请求。根据 body类型，body 编辑器分为5个区域并具有不同的控制。

（温馨提示：点击图片可放大）

包括：none（none没有请求类型，这里不细讲）、form-data、x-www-form-urlencoded、raw、binary。

multipart/form-data编码

（温馨提示：点击图片可放大）

multipart/form-data是 Web 表单用于传输数据的默认编码。这里是模拟在网站上填写表格并提交。表单数据编辑器允许为数据设置键值对。也可以将文件附加到键上。注意：由于 HTML5 规范的限制，文件不存储在历史记录或集合中。下次发送请求时，需要再次选择该文件。目前尚不支持上传多个文件，每个文件都有自己的 Content-Type。

urlencoded编码

（温馨提示：点击图片可放大）

此编码与 URL 参数中使用的编码相同。只需输入键值对，Postman 将正确编码键和值。请注意，无法通过该编码模式上传文件。multipart/form-data和 urlencoded 之间可能存在一些混淆，因此请务必先检查你的API。

raw编码

（温馨提示：点击图片可放大）

原始请求可以包含任何内容。Postman 不会解析在原始编辑框中输入的字符串。无论你在文本区域放置什么，都会随请求一起发送。

binary编码

（温馨提示：点击图片可放大）

二进制数据编码允许你发送无法在 Postman 中输入的内容，例如图像，音频或视频文件。你也可以发送文本文件。如前面在表单数据部分中所提到的，如果要通过历史记录或集合加载请求，则必须重新附加文件。

四、结语

以上简单的介绍了 Postman 的常用功能，如果你跟着走一遍例子，应该就掌握了常用的使用方法。Postman 基本入门写得差不多了，但是这系列的文章还没写完，下一篇文章会深入讲解Postman 的一些高级特性。虽然 Postman 是个简单的调试接口的工具，而且用起来也比较简单。但是如果你善于用它，它会帮你避免很多的 bug。借用荀子在劝学中说过的一句话：“君子生非异地，善假于物也”。