@
star7th 主要就是目前在职公司统一使用的是 yapi 这个接口管理平台,以前刚入行那会都是去的小公司,后端可以自己做一下决定,现在貌似只能听从安排了,哈哈。
说说我使用 yapi 感受吧,也可以当个建议参考
1. 对于开发来说 yapi 有个 json 导入功能,就是模拟器或者 postman 调试完接口后返回的 json 数据,我可以复制后导入到 yapi 的 response 字段中,这样我就不用在手动书写每个返回的字段了,我只要在自动生成的字段后面补充上这个字段是什么含义就好,这点我特别喜欢。
2. yapi 是有人员权限分组的,这个对于开发来说无关痛痒,但是对领导级别的尤其是一共公司中有多支开发团队或者一些有跨部门协作的时候可以申请开通别人组的接口权限,这样我就可以看到部分 api 接口列表了。
3. 这点因人而异,刚看了 showDoc 在编辑文档时是使用 markdown 的方式,这点对于我来说无所谓,但是相对于 yapi 提供的传统方式,鼠标点一下添加一个 request 字段来说还是 yapi 的方便。首先我观察了下,周围的同事好像对 markdown 不感冒,也没见他们用过 markdown 书写文档或者记录。这点会导致他们有点排斥。
其他的 mock 功能就不评价了,我没怎么用过。其实 showdoc 我现在偶尔在用,不过放的都是个人项目的接口,给我自己看的。或者接个外包的时候和别人调试接口的时候用一下,主要是不用登录,地址发给他就能网页直接打开看了。