Postman简介

Postman简介

最近在写自动化运维管理平台的前端部分，平台是基于Django框架写的，在这个过程中，经常需要封装相关的API，而验证API是否能够成功调用必须向对应网址发送GET或者POST请求，于是就接触到了Postman这款接口测试神器。

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的细节部分其实还有很多，这里我仅仅列举了我目前接触到的一些部分，详细的介绍，可以去官网上查看。