小知识,大挑战!本文正在参与“程序员必备小知识”创作活动
项目开发过程中,需要对部署环境中的接口进行测试,就少不了对Postman的使用,而在实际使用中毫无章法,很多功能和内容知其然而不知其所以然,今天就来梳理记录一下Postman工具的界面功能和简单使用流程,以提高项目开发的效率。
1. Postman介绍
Postman是一款发送HTTP请求的网页调试工具,开发人员可以在开发或调试网络程序、网页B/S程序时用来跟踪网络请求,并使用一些网络的监视工具,如Firebug等。Postman作为一个强大的网络请求工具,几乎可以发送所有类型的HTTP请求。
作为一款API请求测试工具,Postman还提供了如集合Collections等功能,使用者可以将自己的接口创建相应的组织结构,更方便项目的整体开发测试。
Postman官方网站:www.postman.com/
2. Postman下载与安装
Postman的可以以多种形式使用,如web页面、chrome插件、客户端程序
2.1 网页版
通过网页版Postman 可以进入Postman网页版,在其中进行请求时需要选择合适的代理,否则有接口无法正常访问
2.2 Chrome插件
在Chrome浏览器商店中搜索postman插件,获取安装,插件版要在谷歌商店中安装,需要梯子。
2.3 客户端
Postman官方提供了windows、mac、linux三种客户端,下载对应的程序安装即可使用,客户端是三种方式中最灵活、功能最丰富的。
- windows客户端下载:www.postman.com/downloads/
3. Postman使用流程
postman客户端拥有的功能是最完整、最全面的,使用时以客户端请求页面为主。
打开Postman后,在标签Home中,点击Create New,选择HTTP Request,就进入了API请求测试页面。
如图是请求页面的展示信息:
3.1 请求名称
Postman是支持保存请求的,在请求页面使用Ctrl + S或者点击页面上保存功能可以将当前请求信息保存,以便于后续的重复使用,请求名称就是保存请求信息时的自定义名称。
请求未保存时名称显示Untitled Request。
3.2 请求类型
Postman支持的请求类型有很多,如GET、POST、PUT、PATCH、DELETE等常见的请求类型
GET
GET请求用户从指定API接口中获取相应数据信息,不会对服务端造成任何数据的修改,输入需要请求的URL后点击Send即可完成请求操作,请求结果显示在下方Response区域。
GET请求仅用来获取数据,在Postman中进行GET请求时,如果需要携带参数,只需要在Params中添加相应的参数,最终请求时参数会以{KEY}={VALUE}的形式拼接在URL之后。
GET请求的详细使用流程:
- 选择请求类型为GET
- 输入需要请求的URL地址
- GET请求输入需要携带的参数信息,以key-value形式,可以为空
- 点击
Send开始请求 - 查看请求结果和返回数据信息
POST
POST是向API接口提交数据的请求操作,可以根据我们提供的数据更新、删除指定的数据信息。
由于POST请求时可能会对服务端数据进行更改,因此大部分的POST请求都需要进行相关的校验,API校验相关的信息就需要在Authorization参数页面进行配置;而POST请求携带的相关数据可以在请求头Headers或者请求体Body中配置。
POST请求的详细使用流程:
- 选择请求类型为POST
- 填入需要请求的URL地址
- 如果API请求需要认证,则使用Authorization配置认证类型或在Headers请求头中使用token认证
- 选择Body标签,配置请求参数
- 请求参数使用时,选择raw即源码格式传输
- 选择JSON指参数以JSON格式输入
- 参数输入区域,以JSON格式写入多个参数,本质是key-value的对象形式
- 点击
Send,开始发起请求 - 查看返回的请求结果信息
3.3 请求参数
Postman最常使用的GET和POST请求中,使用的参数类型有Params、Authorization、Headers、Body四种。
- Params:配置GET类型的请求参数,执行时拼接在URL之后
- Authorization:认证信息配置,POST请求时使用
- Headers:POST请求时设置请求头信息,如浏览器信息等会存在请求头中
- Body:POST请求时的请求体信息,一般用于提交业务相关的参数信息
- none:无,参数置空
- from-data:表单提交的方式,以key-value形式发送
- x-www-from-urlencoded:以key=value形式拼接在URL之后
- raw:源代码格式的参数信息,可以以Text、JavaScript、JSON、HTML、XML的格式写入参数,最常使用的时JSON格式数据的传输。
- binary:二进制文件的传输
- GraphQL:用于应用编程接口的查询语言
- Cookies:用来对请求URL的Cookies信息进行管理
3.4 返回结果
- Body
- Pretty:结果美化展示,选择Pretty时,还可以针对结果数据展示的格式进行选择。如希望数据结果解析为:HTML、JSON、XML、TEXT等多种格式。
- Raw:原生的,即不进行任何修饰的返回结果数据
- Preview:预览,对返回数据的解析预览,如HTML会展示为网页信息
- Cookies:返回结果中带有的Cookies信息
- Headers:返回结果中的Header信息
- Status:请求结果状态,代表请求是否成功或失败的状态码信息
- Time:只请求时间
- Size:请求结果数据的大小
4 总结
文章梳理和记录了Postman常用功能的使用流程,之后再使用Postman测试API时就会有更深刻的认识,尽管是比较简单的内容,但是梳理的过程又是学习的过程,还是能增添一些收获的。希望本篇文章能够帮助到你,有时间会再梳理一下Postman的进阶使用。