其他好用的功能及工具
分组 Collection

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

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

postgres AI插件 postal插件_环境变量

使用了段时间后,建了多个分组的效果:

postgres AI插件 postal插件_API_02

单个分组展开后的效果:

postgres AI插件 postal插件_环境变量_03

历史记录 History

Postman 支持 history 历史记录,显示出最近使用过的 API: 

postgres AI插件 postal插件_IP_04

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

现存问题

在测试 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 的地址:

postgres AI插件 postal插件_IP_05

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

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

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

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

 

很明显,就可以用来实现不用手动修改 url 中的服务器地址,从而动态的实现,支持不同服务器环境:

  • Production 生产环境
  • Development 开发环境
  • Local 本地局域网环境

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


postgres AI插件 postal插件_IP_06

或者:

postgres AI插件 postal插件_IP_07

postgres AI插件 postal插件_环境变量_08

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:

postgres AI插件 postal插件_postgres AI插件_09

点击 Add 后:

postgres AI插件 postal插件_环境变量_10

[info] 环境变量可以使用的地方

  • URL
  • URL params
  • Header values
  • form-data/url-encoded values
  • Raw body content
  • Helper fields
  • 写 test 测试脚本中
  • 通过 postman 的接口,获取或设置环境变量的值。

此处把之前的在 url 中的 IP 地址(或域名)换成环境变量:

postgres AI插件 postal插件_postgres AI插件_11

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

postgres AI插件 postal插件_环境变量_12

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

postgres AI插件 postal插件_IP_13

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

postgres AI插件 postal插件_环境变量_14

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

postgres AI插件 postal插件_IP_15

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

postgres AI插件 postal插件_postgres AI插件_16

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

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

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

postgres AI插件 postal插件_postgres AI插件_17

postgres AI插件 postal插件_IP_18

postgres AI插件 postal插件_API_19

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

 

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

postgres AI插件 postal插件_IP_20

postgres AI插件 postal插件_环境变量_21

环境变量的好处

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

postgres AI插件 postal插件_IP_22

postgres AI插件 postal插件_API_23

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

 

代码生成工具

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

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

postgres AI插件 postal插件_IP_24

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

 

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

比如:

  • Swift 语言

postgres AI插件 postal插件_API_25

  • Java 语言

postgres AI插件 postal插件_API_26

  • 其他各种语言 还支持其他各种语言:

postgres AI插件 postal插件_API_27

目前支持的语言有:

  • 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

 

选中某个分组后点击 Run

postgres AI插件 postal插件_环境变量_28

即可看到测试结果: 

postgres AI插件 postal插件_API_29