Postman API 中文白皮书文档-Postman 使用教程

发布时间: 编辑:CINDY 1人评论 149409次浏览 Chrome开发者工具插件
摘要 : Postman API 官方文档中文翻译,最详细的Postman API白皮书使用文档手册!

前言

到我们chrome插件网寻找插件的用户中有很大一部是Postman插件的用户,作为一个曾经的Web自动化测试人员,深知到一款好用的API自动化测试工具的重要性。尤其作为新人时,Postman的入门并不是那么容易,很多时候我们需要一份详尽的白皮书文档,但是笔者找遍全网也没有找到满意的Postman API 中文白皮书文档。于是心血来潮,不如自己翻译整理!本文基本翻译自postman官方文档,也收集了网络的常见案例。希望这篇拙作能够帮助到你!【不定期更新。。。】

Postman APP安装与更新

Postman APP分为Postman Native APP和Postman Chrome APP两种。(官方推荐使用Postman Native APP,但是老用户使用Postman Chrome扩展程序版本的用户更多一些。官方目前还是处于过度阶段,终极目标还是推广自己的app!)

Postman接口测试工具下载附插件安装使用教程

Postman接口测试工具下载附插件安装使用教程

Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件,是网页接口测试非常好用的工具之一。


Postman Native APP

Postman Native APP可应用于Mac,Windows和Linux操作系统。要安装Postman,请转至应用程序页面,然后单击“根据您的平台下载Mac / Windows / Linux”。如下图所示:

Postman native APP

macOS安装
一旦你下载的应用程序,你可以拖动文件到“应用程序”文件夹。 双击Postman打开应用程序。

Windows安装

  • 下载安装文件
  • 运行安装程序
Linux安装
Linux上的安装可能因分布而有所不同。 请参阅本指南以在Ubuntu 16.04上安装Postman应用程序

Postman Chrome应用程序

我们推荐使用Postman Native APP,但Postman也可以作为Chrome应用程序。 以前,Postman Chrome应用程序的用户必须下载Postman InterceptorChrome扩展程序才能在桌面浏览器中管理Cookie和捕获请求。

Postman Interceptor v1.1.1

Postman Interceptor v1.1.1

Postman Interceptor插件是一款可以帮助用户通过Postman应用程序发送带有浏览器Cookie请求的插件,功能类似fiddler。

Postman Interceptor插件 - 通过Postman发送请求

Postman Interceptor插件 - 通过Postman发送请求

Postman Interceptor是一款可以帮助用户通过Postman应用程序发送带有浏览器Cookie的请求。

Postman Chrome应用程序只能在Chrome浏览器上运行。 要使用Postman Chrome应用,您首先需要安装Google Chrome。如果您已安装Chrome,请转到Chrome网上应用店的postman页面,然后点击“添加到Chrome”。下载应该需要几分钟,这取决于您的网络连接。 一旦你下载了应用程序,你可以启动postman。另外你可以了解一下详细了解为什么支持Postman Chrome应用程序已被弃用。
Postman Chrome应用程序

Postman Chrome APP与Native APP的区别

Postman Native APP是建立在电子Electron,并克服了Chrome平台的一些限制。这里列出了Postman Native APP有的一些功能:
  • Cookies:Postman本机应用程序可让您直接使用Cookie。与Postman Chrome应用程序不同,不需要单独的扩展程序(Postman Interceptor)。
  • 内置代-理:Postman本机应用程序附带一个内置代-理,您可以使用它来捕获网络流量。
  • 菜单栏:本机应用程序不受菜单栏的Chrome标准限制。使用本机应用程序,您可以创建集合,切换到历史记录请求等等。
  • Restricted headers:在Postman chrome应用程序中受限的header,如如Origin和User-Agent。在Postman Native APP都不再受限制。
  • 不要遵循重定向选项:此选项存在于本机应用程序中,以防止返回300系列响应的请求被自动重定向。以前,用户需要使用拦截器扩展才能在Chrome应用中执行此操作。
  • Postman控制台:本地应用程序的最新版本也有一个内置控制台,允许您查看API调用的网络请求详细信息。
(官方文档中还介绍了一些从Postman chrome APP切换到Postman Native App的方法,这里就不多做介绍了,感兴趣的朋友可以自己看!)

Postman Chrome APP自动更新的方法

Postman的Chrome应用程序通常会自动更新。 但是,Postman不控制Chrome应用更新流程,Chrome有时不会长时间更新应用。要手动强制更新,请在Chrome中执行以下操作:
在地址栏中输入chrome:// extensions。在页面顶部,检查并启用开发人员模式。单击开发者模式下方的立即更新扩展按钮。如下图所示:

postman手动更新


Postman的基础功能

postman的基础功能,官方文档介绍的是相当啰嗦,所以笔者这里先简单介绍一下主界面,入门功能就都提到了。稍后我们再一一介绍基础功能的使用方法。

postman基础功能
  1. Collections:在Postman中,Collection类似文件夹,可以把同一个项目的请求放在一个Collection里方便管理和分享,Collection里面也可以再建文件夹。如果做API文档的话,可以每个API对应一条请求,如果要把各种输入都测到的话,就需要每条测试一条请求了。这里我新建了一个example用于介绍整个流程,五个API对应五条请求。这个Collection可以通过https://www.getpostman.com/collections/c8f98a1120357e0d4a5a导入你自己的Postman中。
  2. 上面的黑字注册是请求的名字,如果有Request description的话会显示在这下面。下面的蓝字是保存起来的请求结果,点击可以载入某次请求的参数和返回值。我会用这个功能给做客户端的同事展示不同情况下的各种返回值。保存请求的按钮在15.
  3. 选择HTTP Method的地方,各种常见的不常见的非常全。
  4. 请求URL,两层大括号表示这是一个环境变量,可以在16的位置选择当前的environment,环境变量就会被替换成该environment里variable的值。
  5. 点击可以设置URL参数的key和value
  6. 点击发送请求
  7. 点击保存请求到Collection,如果要另存为的话,可以点击右边的下箭头
  8. 设置鉴权参数,可以用OAuth之类的
  9. 自定义HTTP Header,有些因为Chrome愿意不能自定义的需要另外装一个插件Interceptor,在16上面一行的卫星那里
  10. 设置Request body,13那里显示的就是body的内容
  11. 在发起请求之前执行的脚本,例如request body里的那两个random变量,就是每次请求之前临时生成的。
  12. 在收到response之后执行的测试,测试的结果会显示在17的位置
  13. 有四种形式可以选择,form-data主要用于上传文件。x-www-form-urlencoded是表单常用的格式。raw可以用来上传JSON数据
  14. 返回数据的格式,Pretty可以看到格式化后的JSON,Raw就是未经处理的数据,Preview可以预览HTML页面
  15. 点击这里把请求保存到2的位置
  16. 设置environment variables和global variables,点击右边的x可以快速查看当前的变量。
  17. 测试执行的结果,一共几个测试,通过几个。

这个界面就是免费版的主要内容,和其他API测试工具相比,已经足够好用。如果要使用自动化测试,需要购买9.99美金的Jetpacks,暂时不想购买的话可以试一下Team版Postman。现在是可以免费试用的,不但拥有Jetpacks的功能,还能与其他账户同步Collection。

Postman的使用方法专题

1.Postman插件如何安装

2.Postman如何使用(一):导入导出和发送请求查看响应

3.Postman如何使用(二):Postman Collection的创建/使用/导出分享等

4.Postman如何使用(三):使用数据文件

5.Postman如何使用(四):接口测试

6.postman接口测试教程与实例分享

7.Postman使用教程之如何在不同接口之间传递参数数据

Postman常见问题整理

1、请问下我怎样能用postman工具将所有测试用例能串联起来?最后必要改变我的用例的位置,因为我的测试用例,可能之前就分类好了。

【答】 测试用例只有在一个 Collections 里或者 一个文件夹里才能在一个 runner 里运行,没有发现一次运行多个 Collections 的办法。但是我发现 Postman 提供了 commandline 工具 (https://www.npmjs.com/package/newman) 你可以试一下。
2、postman工具怎样传递csrf参数,因为好多接口都要传递这个参数,关键是取出来后,怎么传递进去,经常遇到“CSRF验证失败. 相应中断”问题。
【答】csrf 参数是在 header 里吗?Postman 由于是 Chrome 扩展的缘故能支持的 header 不多,需要安装 Postman Interceptor才能自定义 header 字段。右上角那个卫星图标就是 Interceptor。

3、MAC上postman离线安装时提示加载扩展程序出错怎么办?

鸣谢以下参考文章作者

1.Postman使用手册系列教程收集整理

2.API自动化测试利器——Postman

查看更多

转载必须注明来自:https://huajiakeji.com/web-development/2017-12/870.html

fiddler (for Windows)

fiddler (for Windows)

1 人评论 48299 次人浏览 4.5分 4.5 分
fiddler是一款HTTP协议下的网络抓包工具,可以用其检测网页和服务器的交互情况,可记录所有客户端和服务器的http和https请求、允许你监视、设置断点、甚至修改输入输出数据。本文提供是是Windows系统下的版本。
fiddler(for Linux)

fiddler(for Linux)

1 人评论 25006 次人浏览 4.3分 4.3 分
fiddler是一款HTTP协议下的网络抓包工具,本文提供是是Linux系统下的版本For Mono framework。
Postman使用教程详解

Postman使用教程详解

0 人评论 6281 次人浏览 4.0分 4.0 分
本文详细介绍Postman使用教程之接口请求测试流程GET、post和管理用例Collection的作用。
基于REST的Web服务客户端

基于REST的Web服务客户端

3 人评论 73856 次人浏览 3.0分 3.0 分
基于REST的Web服务客户端是一款可以使用Chrome插件来模拟REST请求来测试REST风格的web Api的谷歌浏览器插件。
Postman的基础使用方法教程介绍

Postman的基础使用方法教程介绍

0 人评论 5336 次人浏览 3.0分 3.0 分
Postman是一款功能强大的网页调试与发送网页HTTP请求的工具。用于API测试的工具。在我们平时开发中,特别是需要与接口打交道时,无论是写接口还是用接口,拿到接口后肯定都得提前测试一下。我们可以用来很方便的模拟get或者post或者其他方式的请求来调试接口。在Postman中,请求可以保存,也就类似于文件。
评论:(1)

已有 1 位网友发表了一针见血的评论,你还等什么?

  • 1楼 感恩 回复该留言
    多谢翻译整理,有心了。