Chrome插件、Postman

RESTer
You can…

• perform HTTP requests with any method, URL, body and custom headers.
• save favorite requests and organize them in collections.
• view a history of your requests, which i

You can…

• perform HTTP requests with any method, URL, body and custom headers.
• save favorite requests and organize them in collections.
• view a history of your requests, which includes the full request and response.

The add-on supports the following goodies:

• Create and save your authorization headers with Basic or OAuth2 authentication.
• Use placeholders in saved requests.
• Use shortcuts for the frequently used actions (try pressing “?” to see the available shortcuts for the current context).

你可以…
-执行HTTP请求的任何方法，URL，身体和自定义头。
-保存最喜欢的请求并将它们组织到集合中。
-查看您的请求历史，其中我

你可以…
-执行HTTP请求的任何方法，URL，身体和自定义头。
-保存最喜欢的请求并将它们组织到集合中。
-查看请求的历史记录，包括完整的请求和响应。

该插件支持以下好处:
-创建和保存您的授权头与基本或OAuth2认证。
-在保存的请求中使用占位符。
-为经常使用的操作使用快捷方式(尝试按“?”查看当前上下文的可用快捷方式)。

RESTer是一个简单易用的应用程序，用于测试api和web服务器。RESTer非常适合web、移动和桌面开发人员，或者需要测试公开API (Rails、ASP、Express.js)的服务器的任何人。我们对所有HTTP方法的支持对于任何需要测试基于REST的服务器或任何其他东西(SOAP)的人来说都是完美的。RESTer支持Paw和它自己的扩展，这允许它从各种各样的项目(Swagger、HAR、Postman)导入。

Postman

摘要 : Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。
Postman背景介绍
用户在开发或者调试网络程序或者是网页B/S模式的程序的时候是需要一些方法来跟踪网页请求的，用户可以使用一些网络的监视工具比如著名的Firebug等网页调试工具。今天给大家介绍的这款网页调试工具不仅可以调试简单的css、html、脚本等简单的网页基本信息，它还可以发送几乎所有类型的HTTP请求！Postman在发送网络HTTP请求方面可以说是Chrome插件类产品中的代表产品之一。

Postman的操作环境
postman适用于不同的操作系统，Postman Mac、Windows X32、Windows X64、Linux系统，还支持postman 浏览器扩展程序、postman chrome应用程序等。

Postman重要提示：
由于2018年初chrome停止对chrome应用程序的支持，你的postman插件可能无法正常使用了。目前chrome应用商店能使用的就是chrome扩展程序和主题背景。
如果你还想用postman，那么可以使用下面官方推出的Postman 开发者版本。
Postman使用参考文档：
1.官方英文文档

2.chrome插件整理的postman中文使用教程
Postman下载安装

1.postman下载地址：
1.Postman for MAC
2.Postman for windows X64
3.Postman for windows X32
4.Postman for linux X64
5.Postman for Linux X86
2.Postman官网下载地址：
https://www.getpostman.com/apps
3.Postman安装
postman的安装方法分好几种，按照我们上文介绍的那样，我们分为三种安装模式介绍：
1、chrome浏览器postman 插件安装
postman谷歌浏览器的安装插件，所以说它的使用前提是你的电脑上得安装谷歌浏览器才行，在安装了谷歌浏览器后还需要在谷歌网上应用店中下载所需要的Postman插件，该插件的下载方式如下：
chrome浏览器postman 插件安装
不能访问谷歌商店的朋友，可以在本站下载离线安装，离线安装postman插件的方法参照：chrome插件的离线安装方法。最新chrome浏览器下载地址：http://chromecj.com/chrome/2017-09/813.html。
2、Postman电脑客户端安装
Postman的安装非常简单，在windows系统只需要双击安装包，然后什么都不需要操作，它直接就自己完成了，如下图。如果是mac 也是跟普通软件的安装方法相同。在初次登录的时候很多人都没有账号，所以说我们可以直接点击图示中的蓝色字体部分，直接进入Postman的主界面：
Postman电脑客户端安装
如下图，这就是Postman的主界面。
Postman电脑客户端安装

Postman使用方法介绍
Postman
当开发人员需要调试一个网页是否运行正常，并不是简简单单地调试网页的HTML、CSS、脚本等信息是否运行正常，更加重要的是网页能够正确是处理各种HTTP请求，毕竟网页的HTTP请求是网站与用户之间进行交互的非常重要的一种方式，在动态网站中，用户的大部分数据都需要通过HTTP请求来与服务器进行交互。
Postman插件就充当着这种交互方式的“桥梁”，它可以利用Chrome插件的形式把各种模拟用户HTTP请求的数据发送到服务器，以便开发人员能够及时地作出正确的响应，或者是对产品发布之前的错误信息提前处理，进而保证产品上线之后的稳定性和安全性。
Postman插件
在Chrome中安装了Postman插件以后，用户只需要在调试网站的时候启动Postman插件来进行几项简单的配置就可以实现对该网站的基本信息修改和发送各种类型的HTTP到该网站中，用户在发送HTTP数据的时候可以在编写相关测试数据的时候加入一定量的参数信息让测试数据更加准确，而这一切Postman都会完美地支持。
Postman HTTP调试插件
开发人员在使用Postman的时候也许需要经常调试同一个网站或者是同时调试多个网站，如果每次打开Postman插件都要重新设置一遍那样会显得非常麻烦，Postman也考虑到用户的这一个性化需求，所以在Postman的配置页面中，用户可以添加或者管理多个网站用户启动Postman的时候就能自动打开相应的设置。
如果您想了解更多关于Postman的信息，可以访问他们的开发博客，网址是：http://www.getpostman.com/。
Postman注意事项

Postman 接口测试神器

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

以下内容主要参考： Github: api_tool_postman

安装
Postman 可以单独作为一个应用安装，也可以作为 chrome 的一个插件安装。
chrome 插件安装, Postman 插件地址
单独应用安装下载

下面主要介绍下载安装独立版本app 软件的 Postman 的过程：
去主页Postman 官网找到：Postman | Apps
下载Postman的APP
去下载自己平台的版本：
Mac
Windows（x86/x64）
Linux（x86/x64） 即可。

快速入门，总体使用方略

安装成功后，打开软件。

新建接口

对应的Request：New -> Request
Postman新建Request

或，在右边的 Tab 页面中点击加号+：
Postman在Tab页新建Request

即可看到新建的 Tab 页：

Postman新建了的Tab页的Request

设置 HTTP 请求的方法

设置 HTTP 的 Method 方法和输入 api 的地址

Postman设置Method和输入API地址

设置相关请求头信息

Postman设置Header头的key

Postman设置Header头的value

设置相关 GET 或 POST 等的参数

Postman设置POST的Body的JSON

发送请求

都填写好之后，点击 Send 去发送请求 Request：

Postman点击发送请求

查看响应 Response的信息

Postman返回响应

然后可以重复上述修改 Request 的参数，点击 Send 去发送请求的过程，以便调试到 API 接口正常工作为止。

保存接口配置

待整个接口都调试完毕后，记得点击 Save 去保存接口信息：

Postman点击Save保存

去保存当前 API 接口，然后需要填写相关的接口信息：
Request Name: 请求的名字
我一般习惯用保存为 接口的最后的字段名，比如http://{% raw %}{{% endraw %}{server_address}}/ucows/login/login中的/login/login

Request Description: 接口的描述
可选 最好写上该接口的要实现的基本功能和相关注意事项
支持 Markdown 语法

Select a collection or folder to save: 选择要保存到哪个分组（或文件夹）
往往保存到某个 API 接口到所属的该项目名的分组
Postman保存时填写接口信息

填写好内容，选择好分组，再点击保存：
Postman保存到分组

此时，Tab 的右上角的黄色点（表示没有保存）消失了，表示已保存。
且对应的分组中可以看到对应的接口了：

Postman已保存的API接口Tab页

[warning] 默认不保存返回的 Response 数据
直接点击 Save 去保存，只能保存 API 本身（的 Request 请求），不会保存 Response 的数据
想要保存 Response 数据，需要用后面要介绍的 多个 Example

Request 的多参数操作详解

自动解析多个参数 Params

比如，对于一个 GET 的请求的 url 是： 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：

Postman中GET时多个参数
看到展开的多个参数：

Postman中GET中展开的多个参数
如此就可以很方便的修改，增删对应的参数了。

临时禁用参数

且还支持，在不删除某参数的情况下，如果想要暂时不传参数，可以方便的通过不勾选的方式去实现：

Postman中不勾选个别参数

批量编辑 GET 的多个参数

当然，如果想要批量的编辑参数，可以点击右上角的Bulk Edit，去实现批量编辑。

Postman批量编辑GET参数

接口描述与自动生成文档

API 的描述中，也支持 Markdown，官方的接口说明文档：Intro to API documentation。

所以，可以很方便的添加有条理的接口描述，尤其是参数解释了：
Postman给Edit编辑

描述支持 markdown 语法

Postman支持Markdown写描述

而对于要解释的参数，可以通过之前的Param -> Bulk Edit的内容：

Postman批量更新参数

拷贝过来，再继续去编辑：

Postman编辑Markdown描述内容

以及添加更多解释信息：

Postman添加更多的Markdown内容

点击 Update 后，即可保存。

发布接口并生成 markdown 的描述文件

去发布后：

Postman去Publish Docs

对应的效果：有道翻译

Postman发布后Markdown效果

Postman发布后Markdown中代码效果

Response 深入

Response 数据显示模式

Postman 对于返回的 Response 数据，支持三种显示模式。

默认格式化后的 Pretty 模式
Postman的Response的Pretty模式

Raw 原始模式
点击Raw，可以查看到返回的没有格式化之前的原始数据：
Postman的Response的Raw模式

Preview 预览模式
以及 Preview，是对应 Raw 原始格式的预览模式：
Postman的Response的Preview模式

Preview 这种模式的显示效果，好像是对于返回的是 html 页面这类，才比较有效果。

Response 的 Cookies

很多时候普通的 API 调用，倒是没有 Cookie 的：
Postman的响应中无Cookie

Response 的 Headers 头信息

举例，此处返回的是有 Headers 头信息的：

Postman的响应中的Headers

可以从中看到服务器是 Nginx 的。

保存多个 Example

之前想要实现，让导出的 API 文档中能看到接口返回的 Response 数据。后来发现是Example这个功能去实现此效果的。

如何添加 Example

Postman的接口点击Add Example

继续点击Save Example：

Postman的接口点击Save Example

保存后，就能看到Example(1)了：

Postman已保存的Example(1)

单个 Example 在导出的 API 文档中的效果

然后再去导出文档，导出文档中的确能看到返回数据的例子： Postman导出API文档中带Example

多个 Example 在导出的 API 文档中的效果

Postman中多个Example在API文档中效果1

Postman中多个Example在API文档中效果2

其他好用的功能及工具

分组 Collection

在刚开始一个项目时，为了后续便于组织和管理，把同属该项目的多个 API，放在一组里

所以要先去新建一个 Collection: New -> Collection

Postman新建分组Colection

使用了段时间后，建了多个分组的效果：

Postman中的多个分组效果

单个分组展开后的效果：

Postman分组展开的效果

历史记录 History

Postman 支持 history 历史记录，显示出最近使用过的 API： Postman的History显示历史记录

用环境变量实现多服务器版本

现存问题

在测试 API 期间，往往存在多种环境，对应 IP 地址（或域名也不同）

比如：
Prod: http://116.62.25.57/ucows
用于开发完成发布到生产环境
Dev: http://123.206.191.125/ucows
用于开发期间的线上的 Development 的测试环境
LocalTest: http://192.168.0.140:80/ucows
用于开发期间配合后台开发人员的本地局域网内的本地环境，用于联合调试 API 接口
而在测试 API 期间，往往需要手动去修改 API 的地址：

Postman修改APi接口中服务器地址

效率比较低，且地址更换后之前地址就没法保留了。

另外，且根据不同 IP 地址（或者域名）也不容易识别是哪套环境。

Postman 支持用 Environment 环境变量去实现多服务器版本

后来发现 Postman 中，有 Environment 和 Global Variable，用于解决这个问题，实现不同环境的管理：

Postman中Environment和Globals

很明显，就可以用来实现不用手动修改 url 中的服务器地址，从而动态的实现，支持不同服务器环境:
Production 生产环境
Development 开发环境
Local 本地局域网环境

如何使用 Enviroment 实现多服务器版本

Postman中点击?的Add

或者：

Postman中点击设置Manage Enviroments

Postman中Manage Enviroments的Add

Environments are a group of variables & values, that allow you to quickly switch the context for your requests and collections.
Learn more about environments
You can declare a variable in an environment and give it a starting value, then use it in a request by putting the variable name within curly-braces. Create an environment to get started.
输入 Key 和 value：

Postman中Enviroment输入key和value

点击 Add 后：

Postman保存Enviroment

[info] 环境变量可以使用的地方
URL
URL params
Header values
form-data/url-encoded values
Raw body content
Helper fields
写 test 测试脚本中
通过 postman 的接口，获取或设置环境变量的值。

此处把之前的在 url 中的 IP 地址（或域名）换成环境变量：

Postman把IP换成环境变量

鼠标移动到环境变量上，可以动态显示出具体的值：

Postman环境变量鼠标动态提示

再去添加另外一个开发环境：

Postman添加Dev环境变量

则可添加完 2 个环境变量，表示两个服务器地址，两个版本：

Postman已添加2个环境变量

然后就可以切换不同服务器环境了：

Postman切换不同服务器环境

可以看到，同样的变量 server_address，在切换后对应 IP 地址就变成希望的开发环境的 IP 了：

Postman切换到Dev的IP地址

Postman 导出 API 文档中多个环境变量的效果

顺带也去看看，导出为 API 文档后，带了这种 Environment 的变量的接口，文档长什么样子：

发现是在发布之前，需要选择对应的环境的：

Postman发布前要选择环境

Postman选择某个环境

Postman已选择了某个环境

发布后的文档，可以看到所选环境和对应服务器的 IP 的：
Postman发布后看到所选环境的IP

当然发布文档后，也可以实时切换环境：

Postman发布后可以切换环境

Postman切换到某个环境看到IP

环境变量的好处

当更换服务器时，直接修改变量的 IP 地址：

Postman环境变量要更换IP地址

Postman环境变量更换为新IP

即可实时更新，当鼠标移动到变量上即可看到效果：

Postman鼠标移动到环境变量显示新IP

代码生成工具

查看当前请求的 HTTP 原始内容

对于当前的请求，还可以通过点击 Code

Postman中点击Code

去查看对应的符合 HTTP 协议的原始的内容：

Postman查看请求的Http的原始内容

各种语言的示例代码Code Generation Tools

比如：

Swift 语言
Postman把请求生成Swift代码

Java 语言
Postman把请求生成Java代码

其他各种语言 还支持其他各种语言：
Postman把请求生成其他各种语言的代码

目前支持的语言有：

HTTP
C (LibCurl)
cURL
C#(RestSharp)
Go
Java
OK HTTP
Unirest
Javascript
NodeJS
Objective-C(NSURL)
OCaml(Cohttp)
PHP
Python
Ruby(NET::Http)
Shell
Swift(NSURL)
代码生成工具的好处是：在写调用此 API 的代码时，就可以参考对应代码，甚至拷贝粘贴对应代码，即可。

测试接口

选中某个分组后，点击 Runner

Postman中点击Runner

选中某个分组后点击 Run

Postman中点击Run去测试

即可看到测试结果： Postman中测试API的结果

关于此功能的介绍可参考Postman 官网的git 图

MockServer

直接参考官网。

功能界面

多 Tab 分页

Postman 支持多 tab 页，于此对比之前有些 API 调试工具就不支持多 Tab 页，比如Advanced Rest Client

多 tab 的好处：

方便在一个 tab 中测试，得到结果后，复制粘贴到另外的 tab 中，继续测试其它接口

比如此处 tab1 中，测试了获取验证码接口后，拷贝手机号和验证码，粘贴到 tab2 中，继续测试注册的接口

Postman拷贝Tab1中验证码

Postman粘贴验证码到Tab2

界面查看模式

Postman 的默认的 Request 和 Response 是上下布局：

Postman默认是上下布局

此处点击右下角的Two pane view，就变成左右的了：

Postman换成左右布局

[info] 左右布局的用途
对于数据量很大，又想要同时看到请求和返回的数据的时候，应该比较有用。

多颜色主题

Posman 支持两种主题：

深色主题
当前是深色主题，效果很不错：

Postman的设置深色主题

Postman的深色主题的效果

浅色主题
可以切换到 浅色主题：

Postman切换浅色主题

Postman浅色主题效果

API 文档生成

在服务端后台的开发人员测试好了接口后，打算把接口的各种信息发给使用此 API 的前端的移动端人员时，往往会遇到：

要么是用复制粘贴 -> 格式不友好 要么是用 Postman 中截图 -> 方便看，但是不方便获得 API 接口和字段等文字内容 要么是用 Postman 中导出为 JSON -> json 文件中信息太繁杂，不利于找到所需要的信息 要么是用文档，比如去编写 Markdown 文档 -> 但后续 API 的变更需要实时同步修改文档，也会很麻烦 这都会导致别人查看和使用 API 时很不方便。

-> 对此，Postman 提供了发布 API

预览和发布 API 文档 下面介绍 Postman 中如何预览和发布 API 文档。

简要概述步骤

Collection
鼠标移动到某个 Collection，点击 三个点
Publish Docs
Publish
得到 Public URL
别人打开这个 Public URL，即可查看 API 文档

预览 API 文档

点击分组右边的大于号>

Postman的分组右边的>

如果只是预览，比如后台开发员自己查看 API 文档的话，可以选择：View in web

Postman的分组的View in web

等价于点击Publish Docs去发布：
Postman的分组点击Publish Docs

View in Web 后，有 Publish 的选项（见后面的截图）

View in Web 后，会打开预览页面：

比如：

奶牛云

https://documenter.getpostman.com/collection/view/669382-42273840-6237-dbae-5455-26b16f45e2b9

Postman的API文档预览-1

Postman的API文档预览-2


而右边的示例代码，也可以从默认的 cURL 换成其他的：

示例代码从cURL换成Python

API文档中Python示例代码

发布 API 文档

如果想要让其他人能看到这个文档，则点击 Publish：

API文档中点击Publish去发布

然后会打开类似于这样的地址：

Postman Documenter

https://documenter.getpostman.com/collection/publish?meta=Y29sbGVjdGlvbl9pZD00MjI3Mzg0MC02MjM3LWRiYWUtNTQ1NS0yNmIxNmY0NWUyYjkmb3duZXI9NjY5MzgyJmNvbGxlY3Rpb25fbmFtZT0lRTUlQTUlQjYlRTclODklOUIlRTQlQkElOTE=

Postman确认发布分组的API文档

点击 Publish 后，可以生成对应的公开的网页地址：

Postman已发布文档得到公开链接

打开 API 接口文档地址：

https://documenter.getpostman.com/view/669382/collection/77fd4RM

即可看到（和前面预览一样效果的 API 文档了）：

Postman已发布的API文档效果

如此，别人即可查看对应的 API 接口文档。

已发布的 API 文档支持自动更新

后续如果自己的 API 接口修改后：

比如：

Postman去Edit编辑API

Postman的API更新编辑Edit Request

（后来发现，不用再去进入此预览和发布的流程，去更新文档，而是 Postman 自动支持）

别人去刷新该文档的页面：

https://documenter.getpostman.com/view/669382/collection/77fd4RM

即可看到更新后的内容：

Postman自动更新了已发布的API文档

参考资料