初学者：Postman 入门教程

浅浅的花香味﹌ 2024-02-19 14:38 46阅读 0赞

**目录**

一、引言

二、Postman下载

三、入门例子

四、结语

--------------------

## 一、引言 ##

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

## 二、Postman下载 ##

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

## 三、入门例子 ##

**1、发送第一个请求**

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

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70][]

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

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

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

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 1][]

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 2][]

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

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

**3、查看请求头**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 3][]

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

**4、查看请求体**

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 4][]

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

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

***multipart/form-data编码***

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 5][]

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

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

***urlencoded编码***

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 6][]

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

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

***raw编码***

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 7][]

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

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

***binary编码***

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 8][]

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

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

## 四、结语 ##

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

[Download Postman _ Get Started for Free]: https://www.getpostman.com/downloads/
[https_postman-echo.com_get_test_123]: https://postman-echo.com/get?test=123
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/81f3cf88bb644bf6ab1e1638549ec1b8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/dc7d7b08de764224915a282860fe02c3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/6ffaa10a62fb4961b4b93b4d5c165a7d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/874628799559432d8f5a2d9c1de3a4a6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/21feab5900b64c7a976092b0a13e5739.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/f7eb6409f8b84f568ede22a44e7be288.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/930041cd896e4c44b62e4a86ef370116.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/9b569b27104140198ad43a63e0678729.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tleWJvYXJkXw_size_16_color_FFFFFF_t_70 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/8bb4972c4be24e80a52060c2078940dc.png