postman接口测试工具生成接口文档

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

简要概述步骤
Collection
鼠标移动到某个Collection,点击 三个点
Publish Docs
Publish
得到Public URL
别人打开这个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

即可看到更新后的内容:
在这里插入图片描述
出处: https://crifan.github.io/api_tool_postman/website/postman_api_doc/preview_publish_api_doc.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值