postman接口测试五

目录

功能界面

多 Tab 分页

界面查看模式

多颜色主题

API 文档生成

简要概述步骤

预览 API 文档

发布 API 文档

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


功能界面

多 Tab 分页

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

多 tab 的好处:

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

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

界面查看模式

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

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

[info] 左右布局的用途

对于数据量很大,又想要同时看到请求和返回的数据的时候,应该比较有用。

多颜色主题

Posman 支持两种主题:

  • 深色主题

当前是深色主题,效果很不错:

  • 浅色主题

可以切换到 浅色主题:

API 文档生成

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

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

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

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

简要概述步骤

  1. Collection

  2. 鼠标移动到某个 Collection,点击 三个点

  3. Publish Docs

  4. Publish

  5. 得到 Public URL

  6. 别人打开这个 Public URL,即可查看 API 文档

预览 API 文档

点击分组右边的大于号>

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

等价于点击Publish Docs去发布:

View in Web 后,有 Publish 的选项(见后面的截图)

View in Web 后,会打开预览页面:

比如:

奶牛云

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

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

发布 API 文档

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

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

Postman Documenter

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

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

打开 API 接口文档地址:

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

即可看到(和前面预览一样效果的 API 文档了):

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

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

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

比如:

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

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

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

即可看到更新后的内容:

猜你喜欢

转载自blog.csdn.net/weixin_37018468/article/details/106193431