一. 前言

我们在后台开发期间,尤其是HTTP的RESTful API时,往往需要在实现了后台的接⼝代码后,找合适的⼯具去调试以验
证和确保⾃⼰的API接⼝是可以正常⼯作的。
这时候,找到合适的API调试⼯具,就显得很重要。因为合适的⼯具可以极⼤地提⾼⼯作效率,减少⽣命的浪费。
Postman是个⾮常好⽤的API调试⼯具,所以在此推荐之。
下⾯就来详细的解释Postman的各种功能的⽤法。

二. 下载安装

1. 下载Postman

官方最新版本下载链接:
Win64
Linux
Mac

2. 安装Postman

官方安装文档

3. 安装中文补丁

汉化包下载链接

三. 集合—Collections

1. 新建集合用于管理用例

在刚开始⼀个项⽬时,为了后续便于组织和管理,把同属该项⽬的多个API,放在⼀组⾥,所以要先去新建⼀个Collection(集合)。
选择对应的工作区进入,点击新建,选择集合,对其进行重命名
新建.png
新建界面.png

2. 集合管理精细化

这里我们可以针对不同的请求方式做分组
右击集合,菜单中选择“添加文件夹”,添加后重命名文件夹
这是我们精细化划分之后的结果,是不是看着有条理多了?
集合精细化管理.png

四. 接口请求流程

1. GET 请求

GET请求:点击参数(Params),输入键和值,可输入多个,即时显示在URL链接上。
GET请求的请求头与请求参数如在接口文档中无特别声明时,可以不填。
GET请求.png
响应体示例:响应的格式可以有多种,我这里由于请求的是自己写的演示接口,响应的是 JSON,一般情况下,我们自定义接口的话是 json格式的响应体。如果是网页的话,就是html格式的响应体。

2. POST请求

下图示例中设置了请求方法,请求URL,请求参数,但是没有设置请求头
在我的使用过程中,请求头是根据请求参数的形式自动生成的
请求头中的Content-Type与请求参数的格式之间是有关联关系,比如:

POST参数格式Content-Type参数示例
表单提交application/x-www-form-urlencodeduser_name=123&password=111
JSON提交application/json{user_name=123,password=111}
XML提交application/xml< ?xml version="1.0" encoding="utf-8"?> 悟空传 < /book1>

POST请求.png

3. 其他请求

其它请求方式如PUT,DELETE 大致流程和GET,POST 差不多,这里就不一一举例说明了

4. body部分编辑

form-data:form-data是web表单默认的传输格式,编辑器允许你通过设置key-value形式的数据来模拟填充表单。你可以在最后的选项中选择添加文件。

x-www-form-urlencoded:这个编码格式同样可以通过设置key-value的方式作为URL的参数。

raw:一个raw请求可以包含任何内容。在这里你可以设置我们常用的JSON 和 XML数据格式。

二进制(binary):在这里你可以发送视频、音频、文本等文件。

五. 处理响应

1. 查看响应

Postman的body标签中有三种查看方式:Pretty、Raw、Preview
美化(Pretty):Pretty方式,可以让JSON 和 XML的响应内容显示的更美观规整。
美化.png

原始(Raw):显示最原始的数据,可以帮助你判断是否minified
原始.png

预览(Preview):可以帮你把HTML页面自动解析显示出来。
预览.png

2. Headers

这里显示了一些键值对,表示了HTTP请求中header中的信息。

3. Cookies

可以显示浏览器的cookie。

六. 导入导出数据

1. 导出单个集合数据

右击需要导出数据的集合,点击导出。按照提示导出即可。
导出单个集合数据.png

2. 导出所有集合数据以及工作环境

点击设置
点击设置.png
点击数据-选择导出数据,按照提示导出即可
导出所有集合数据.png

3. 导入集合数据包

导入数据包.png

4. 导入所有集合数据以及工作环境

导入所有数据.png

七. 环境变量

当使用API的时候,你可能经常需要使用不同的设置。环境设置可以让你使用变量自定义request。这个方法可以让你轻松的在不同的设置之间改变而不用改变你的request。你不需要担心要记住Postman中所有的这些变量的值。环境可以下载保存为JSON文件,以后可以再加载他。

环境变量被设置为键值对,键为变量的名字。
变量可以以这个形式使用: {
},这个字符串{} 将会被他的值所替代。例如:环境变量名为 'url',值为 'http://localhost' ,你可以在request的URL字段中使用{},{}将会在request发送时被替换成 'http://localhost'。
环境变量设置.png

1. 全局变量

全局变量提供了一组总是有效的变量。你可以有很多环境变量,但是同一时间只能有一组有效。但是你可以像使用环境变量一样使用全局变量。

如果一个有效的环境变量名和全局变量名重名,那么全局变量名将被环境变量名覆盖。

2. 添加新的环境变量并启用

点击添加环境变量,并重命名
添加环境变量.png

在对应需要用到该环境变量的集合或者api的右上角上,启用刚刚添加的环境
启用环境变量.png

当我们选择了环境之后,Postman将会用变量的值替代所有的变量。如果没有选择环境,Postman将会在全局变量中寻找对应的变量。

八. History历史

所有你使用Postman发送的request都将保存在左侧边栏的History中,他会帮助你通过尝试不同的request来生成一个新的request,而不必浪费你太多的时间。你可以通过单击一个request的名字来加载他。
历史.png
如果你创建了Postman的账户,你的历史数据将被同步到Postman的服务器,你可以在不同的平台上使用Postman的时候同步你的数据。

九. 身份验证

(待完善)

Q.E.D.





莫道君行早,更有早行人。