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

CINDY 0人评论 分类:开发者工具
摘要 : 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 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 Interceptor Chrome扩展程序才能在桌面浏览器中管理Cookie和捕获请求。详细了解为什么支持Postman Chrome应用程序已被弃用。
Postman Chrome应用程序只能在Chrome浏览器上运行。 要使用Postman Chrome应用,您首先需要安装Google Chrome。如果您已安装Chrome,请转到Chrome网上应用店的postman页面,然后点击“添加到Chrome”。下载应该需要几分钟,这取决于您的网络连接。 一旦你下载了应用程序,你可以启动postman。
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如何使用(一):导入导出和发送请求查看响应

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

转载必须注明来自: Chrome插件 » Postman API 中文白皮书文档-Postman 使用教程

Postman for Linux(x64)

Postman for Linux(x64)

0 人评论 7116 次人浏览 2.0分 2.0 分
Postman for Linux(x64)是一款针对Linux系统x64架构的功能强大的网页调试与发送网页HTTP请求应用程序。
Postman for Linux(x86)

Postman for Linux(x86)

0 人评论 2882 次人浏览 4.0分 4.0 分
Postman for Linux(x86)是一款针对Linux系统x86架构的功能强大的网页调试与发送网页HTTP请求应用程序。
Postman for Win32

Postman for Win32

0 人评论 9615 次人浏览 3.5分 3.5 分
Postman for Win32是一款针对Win32系统的功能强大的网页调试与发送网页HTTP请求应用程序。
Postman for mac

Postman for mac

2 人评论 17713 次人浏览 2.7分 2.7 分
Postman for mac是一个提供在MAC设备上功能强大的开发,监控和测试API的绝佳工具。
Postman

Postman

22 人评论 1845325 次人浏览 4.0分 4.0 分
Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。
Postman for Win64(V6.0.10)

Postman for Win64(V6.0.10)

6 人评论 43862 次人浏览 3.5分 3.5 分
Postman for Win64(V6.0.10)是一款针对Win64系统的功能强大的网页调试与发送网页HTTP请求应用程序。
Postman for Mac(v6.2.3)

Postman for Mac(v6.2.3)

0 人评论 635 次人浏览 4.0分 4.0 分
Postman是一款基于不同操作系统提供功能强大的 Web API & HTTP 请求调试的工具。最新版本是8.2日发布的Postman Mac(v6.2.3)。
评论:(0)

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