各位公司的 API 接口文档是用的什么方式？

[aschoolboy]

之前公司的 API 接口文档写在 word 里，放在 github 上。
缺点很多，不能同时编辑，一同时编辑就冲突.
我趁一期项目结束，搭了个开源 API 接口网站：eolinker。
给师父看了，说可以，叫我把所有接口都牵进去了。准备让所有同事用了。
结果有的同事一看感觉不方便，说可以用 markdown 来写。
又安排我找个用 markdown 写的 api 文档模板

所以想问问大家的 api 接口文档是采用什么方式的？

[joeke]

showdoc apizz 都比较好用

[jasonslyvia]

swagger + pont + ts，如丝般顺滑

[jianlu]

showdoc + 1

[adrianXu]

swagger2

[guoyuchuan]

swagger

[TommyLemon]

@adrianXu 你是怎么发出图片的？

[adrianXu]

@TommyLemon #46 截图 command+v

[CabalPHP]

http://demo.cabalphp.com/__docs

[jinhan13789991]

后台口头传述，绝对不会泄露

[specita]

在用 Apiary，不过语法要了解下不怎么方便，学习成本有点高, 正准备换

[IMuMa3]

eoLinker +1

[lydbilibili]

没有文档

[Heanes]

swagger 或者 rap

[tt67wq]

我司一般靠睿智的程序员去源码里面考古

[Smilencer]

之前用 swagger，现在我再推广使用 postman collection, 作为后端必须产出文档之一。前端和测试 MM 都夸我好贴心，后端兄弟对我恨子入骨。。。

[A555]

给个地址 给个例子 自己玩

[TommyLemon]

https://oscimg.oschina.net/oscnet/f123d05a95009216791d54831d266448cac.jpg

自动生成文档，清晰可读永远最新
自动生成请求代码，支持 Android 和 iOS
自动生成 JavaBean 文件，一键下载
自动管理与测试接口用例，一键共享
自动校验与格式化 JSON，支持高亮和收展

有视频教程哦
apijson.org

GitHub 右上角点 Star 支持下吧，谢谢^_^
github.com/TommyLemon/APIJSON

[TommyLemon]

<img src="https://oscimg.oschina.net/oscnet/f123d05a95009216791d54831d266448cac.jpg" />

[TommyLemon]

@Smilencer Swagger,APIDoc 等都要后端写大量注解代码啊，能不恨你么哈哈？
用 APIJSONAuto 好了，全自动生成，一行代码都不用写

[linxl]

粘贴一段 json, 附上 url, method. 哈哈哈