1.Postman简介
Postman是在开发或者调试网络程序的时候用来跟踪网页请求的工具,简单来说,它是用来进行接口测试和跟踪http请求的工具,这里给出github的地址:
https://github.com/postmanlabs
Postman的优点有以下几类:
· 支持各种的请求类型: get、post、put、patch、delete 等
· 支持在线存储数据,通过账号就可以进行迁移数据
· 很方便的支持请求 header 和请求参数的设置
· 支持不同的认证机制,包括 Basic Auth,Digest Auth,OAuth 1.0,OAuth 2.0 等
· 响应数据是自动按照语法格式高亮的,包括 HTML,JSON 和 XML
Postman最早是作为chrome浏览器插件存在的,现在一般下载独立的安装包,它同时支持MAC、Windows和Linux,window下面的安装包安装过程很简单,这里就不赘述了,主要讲讲这个东西怎么用。
2.Postman的基础功能
Postman的界面分为 左边的侧边栏 和 右边的请求构建器 两部分。请求构建器允许你可以快速的创建几乎任何类型的请求。一个HTTP请求的四部分:URL、Method、Headers、Body,在Postman中都可以设置。具体的页面布局如下:
2.1 如何发送HTTP请求?
假如我们要发送一个GET请求,首先需要把请求类型改为GET,如下图:
然后在params参数部分填写相应的参数,点击蓝色的send按钮,会出现右下角的状态相应码、响应时间以及响应大小。
最终通过JSON或者HTML的方式返回给我们对应的结果。这里访问的是百度的首页,所以返回的HTML代码如下:
当返回我们想要的结果时,我们可以点击蓝色send按钮后面的save来进行保存。
2.2 自动解析多个参数 Params
当我们发起一个get请求是:
http://openapi.youdao.com/api?q=纠删码(EC)的学习&from=zh_CHS&to=EN&appKey=152e0e77723a0026&salt=4&sign=6BE15F1868019AD71C442E6399DB1FE4
对应着其实是?key=value形式中包含多个 Http 的 GET 的 query string=query parameters,这个时候,Postman可以自动帮我们解析出对应的参数,点击params就可以看到:
如果我们临时不想要某个参数,只需要取消掉参数前面的对勾就行。
2.3 API 文档生成
在服务端后台的开发人员测试好了接口后,打算把接口的各种信息发给使用此 API 的前端的移动端人员时,往往会遇到:
要么是用复制粘贴 -> 格式不友好,要么是用 Postman 中截图 -> 方便看,但是不方便获得 API 接口和字段等文字内容 要么是用 Postman 中导出为 JSON -> json 文件中信息太繁杂,不利于找到所需要的信息 要么是用文档,比如去编写 Markdown 文档,但后续 API 的变更需要实时同步修改文档,也会很麻烦 这都会导致别人查看和使用 API 时很不方便。
对此,Postman 提供了发布 API预览和发布 API 文档,点击左侧的collection分组中的三角符号,然后点击view in web,会打开预览页面,就可以看到相应的API文档内容。
此时如果想让其他人能看到这个文档,则点击右上角的Publish,可以生成对应的公开的网页地址,这样其他人就能访问你这个API接口文档了。
上面的下拉框中可以选择示例代码的类型,这里的示例代码是指符合HTTP协议的原始内容,代码生成工具的好处是:在用不同的编程语言写调用此 API 的代码时,就可以参考对应代码,甚至拷贝粘贴对应代码即可。目前支持的代码类型有:
· HTTP
· C (LibCurl)
· cURL
· C#(RestSharp)
· Go
· Java
· Javascript
· NodeJS
· Objective-C(NSURL)
· OCaml(Cohttp)
· PHP
· Python
· Ruby(NET::Http)
· Shell
· Swift(NSURL)
上一条:Postman中变量的使用
下一条:Postman软件介绍