塘下做网站,财务部官方网站经济建设司,wordpress 产品 插件,自建的电子网站如何做推广引言
几个朋友想做一个前后端分离的项目#xff0c;接口文档的重要性那是不言而喻的。生成接口文档的方法真的太多了#xff0c;Yapi、Swagger等等。但是想公网上访问接口文档并修改的话#xff0c;还得购买服务器#xff0c;部署上去。穷码农#xff0c;哪有钱购买服务器…引言
几个朋友想做一个前后端分离的项目接口文档的重要性那是不言而喻的。生成接口文档的方法真的太多了Yapi、Swagger等等。但是想公网上访问接口文档并修改的话还得购买服务器部署上去。穷码农哪有钱购买服务器。如果我不想购买服务器部署又想让不在一块的前端和后台小伙伴能同时访问并修改接口文档该怎么办postman团队背靠google贼有钱提供了域名和服务器所有人都可以查看文档。并且可以创建团队团队成员根据角色可对空间中的文档进行查看或编辑。废话不多说上干货(多图预警)
创建接口集合
首先要求必须登录postman才行不然无法进行后边的生成文档操作
创建集合 在集合中添加接口 为接口生成样例
上边创建好请求之后就可以进行正常的请求了。但是如果说接口还没开发先写的文档也可以将规定的返回值结构粘贴到返回值的Body中 现在为接口生成一个成功的样例 然后再生成一个失败的样例。同样的方法我们将失败的返回值结构粘贴到返回值Body中然后点击右上角的example然后点击Add Example 异常的情况就不再举例也是一样的方法
生成文档 点击View in web即可。生成的文档的样子如下: 右侧的的下拉可以选择成功或失败时的返回值结构
了解了如何生成文档那如何创建一个团队允许团队成员进行接口文档的操作也是十分重要的
创建团队
创建团队 创建完成之后进入团队空间 添加集合
创建完空间之后可以向空间中添加集合或API 此时便可以在该空间下添加的集合点击集合名称即可进入到文档页 说完了如何添加集合下边看一下如何往团队中添加成员
添加成员
首先进入到团队管理中 然后点击右侧的Invite Users会进入邀请成员的页面 邀请之后对方同意之后便可以在团队管理中看到成员(团队最多5个人)
之后想共同管理接口文档只需要访问创建团队时生成的url即可对文档进行管理。虽然不像swagger和Yapi那样功能强大但是对开发一个小项目来说还是够用的
