后端不写 api 文档怎么办, V 友们究竟是怎么解决的

查看 117|回复 7
作者:unt   
后端只写 swagger,那玩意儿真的是狗都不看,为什么能设计得如此丑陋,有没有写得好的 swagger 让我看看,看是我们后端的问题还是这个工具的问题。
像下图这种文档只能手码吗,有工具吗

swagger, 手码, 文档, 萤石

owen800q   
叫他直接给 postman collection, 自己生成 html 文档
https://github.com/karthiks3000/postman-doc-gen
bojackhorseman   
https://github.com/acacode/swagger-typescript-api
我都是用这个库根据 swagger.json 生成请求文件,支持 axios 模板。
后端手写文档的我才想骂人了,改了接口也不同步。swagger 方便的一批。
owen800q   
@owen800q 我日常工作就是這樣做的,現實是後端不可能寫文檔,至少我沒見過會給文檔的後端開發
lei2j   
swagger 写的多方便啊,参数变了立马同步
SuperManNoPain   
现在不会有人特地去手写的,都是写备注配合插件自动同步或者直接 swagger 了,
LeegoYih   
Swagger 只是一个 UI 啊,它是基于 OpenAPI 规范实现的,有很多工具可以通过 OpenAPI 反向生成代码,比如: https://github.com/alibaba/pont
Vegetable   
后端给了 Swagger 自己嫌丑?我冒昧的问一句,市面上有但凡一个流行的文档工具不支持导入 Swagger 吗?
您需要登录后才可以回帖 登录 | 立即注册

返回顶部