Postman第九篇：API 文档生成

预览 API 文档

点击分组右边的大于号>

API 文档生成 在服务端后台的开发人员测试好了接口后，打算把接口的各种信息发给使用此 API 的前端的移动端人员时，往往会遇到： -> 对此，Postman 提供了发布 API 预览和发布 API 文档 下面介绍 Postman 中如何预览和发布 API 文档。 简要概述步骤 Collection 鼠标移动到某个 Collection，点击 三个点 Publish Docs Publish 得到 Public URL 别人打开这个 Public URL，即可查看 API 文档

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

等价于点击Publish Docs去发布：

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

即可看到更新后的内容：