用了 swagger,感觉非常不舒服,
- 首先,用 yaml 作为接口文档定义的工具真的很麻烦
- 其次,还有很多语法要去官方查,感觉非常难受
所有有没有更加简单的接口文档维护的工具,虽然写 markdown 在 wiki 上也可以。 求的是一款不耗精力的接口文档维护平台,另外可以顺带 mock 就再好不过了。
用了 swagger,感觉非常不舒服,
所有有没有更加简单的接口文档维护的工具,虽然写 markdown 在 wiki 上也可以。 求的是一款不耗精力的接口文档维护平台,另外可以顺带 mock 就再好不过了。
1
baojiweicn2 OP 要是可以当即发一条请求,自动抓成接口文档就更好了,不然还要自己手动写很烦
|
2
WhoMercy Apr 23, 2019
如果是 Java 项目,可以了解一下 springfox-swagger (省去了 swagger 手写 yaml 的痛苦)
|
3
AngryMagikarp Apr 23, 2019
你说的这亮点都是你自己没有熟悉 swagger 而已。
|