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

当时做 oneapi.app 的一个原因就不想被这种事情卡住。只要后端的代码他们自己能看懂前端就能用

swagger 就够了呀，只是美丑的问题，又不是没有接口文档

proto 即文档，字段与功能一致，标清楚字段含义哪些必填哪些选填。想要单独的文档我是反对的，文档与接口定义分离的后果往往就是文档不及时更新，然后 OP 又要发帖，后端不及时更新 api 文档怎么办。

不用解决，有锅直接甩

swagger 这种感觉侵入性太强了,目前用的是 smrt-doc,通过注释生成 html 或者 swagger 以及 postman,都是 java doc 注释,没啥侵入性
https://github.com/smart-doc-group/smart-doc

@unt 为公司考虑, 你是要笑死我, 然后公司把你开了

rap2.taobao.org BUG 虽然多了点，但勉强能用。数据要动态扩展的另说。

可以让后端接一下这个 https://doc.xiaominfo.com/ ，swagger 的一个新的 ui

"Swagger 狗都不看"，你再骂！

虽然不说精通，前端也稍微懂点后端吧，后端也稍微懂点前端吧，像我们这边接口文档一般用 swagger 的 json 导入到 apifox 给前端，有时候前端着急都直接去看看 Controller 就完了，有时候后端接口有小的改动也可以前端代码里面一搜索一起改了就好了，人人都只管自己端的东西，然后要求对方给完美的交付物的话那中间连接这块就是事多。

"Swagger 狗都不看"，再骂！

直接后端代码丢给前端去对接，代码就是最好的接口文档😆

swagger 文档都给了，稍微在问一下沟通一下，互相包含以下的事情，还在这里抱怨，那只能后端都学一下前端，直接挤掉前端岗位，前端学后端直接挤掉后端岗位，无沟通成本。开卷

连个 swagger 都看不明白吗。。。

@unt 那不是 swagger 的问题。。是人的问题。找后端 leader 说，这样不行。要改。我见过很多后端图省事把数据库直接反回来，前端自己挑自己用的。。然后零注释

swagger 都没得你见过吗？

作为后端 我直接生成 ts 包，连所有的 interface 每个字段都有注释，直接调用就完事。

生成 swagger 拖到 yapi 就好了

记得之前项目接口文档都是在 ApiFox 上谁开发的接口谁写文档 与其和 swagger 这种工具死磕不如换一种管理思路

我不爱用 swagger ，而且我一般是先写文档后开发的。不然让前端等接口？