需要和后端共同约定一套 api,所以需要我来编写 api 文档,看了很多目前最流行的 swagger 的文档,不是很懂,我需要的只是编写 api 文档,并不需要 mock 和测试之类,感觉用 swagger 好复杂的样子.找了很久发现阿里的 rap 的 1.0 版本(不是 2.0)比较符合我的需求,但是很无语的一点是定义的参数列表是按照首字母排序的,好不爽.请问还有比较好用的 api 文档编写工具推荐吗?或者说这种情况下 swagger 适合我的需求吗?
This topic created in 3104 days ago, the information mentioned may be changed or developed.
Supplement 1 · Dec 7, 2017
多谢各位的推荐,目前在用sosoapi,基于swagger,不用再用YAML或者JSON语法来敲代码了,非常简单易上手,推荐有需要的可以试一下
 |
1
lizheming Dec 5, 2017
我一直在用 http://apidocjs.com/ 感觉也还不错
|
 |
2
zthxxx Dec 5, 2017
|
 |
3
balabalaguguji Dec 26, 2018
推荐你 https://easydoc.xyz 专为 api 文档定制的工具，肯定很适合你
|
Select Language