有没有从 json 生成接口文档的工具

[pheyer]

小公司伤不起啊，各种接口都是靠QQ传达的，还只有request请求，返回的json要靠自己抓包看。突然想到能不能这样做：给定一个request请求和返回的json，就能生成接口文档呢？

[hging]

同求.

[phoenixlzx]

这个。。。自己写也不难吧

[hcymk2]

swagger

[janxin]

如果完全自动化应该不太可能吧，怎么知道你的每个参数和返回是啥意思....

不过我觉得swagger应该能满足你们的需求，可以从一个json生成文档和测试用例。不过json有格式要求。 http://swagger.io

有在线编辑器直接写文档，yaml格式。 http://editor.swagger.io，可以到处成json，也可以直接生成对应的client代码

[virusdefender]

以前写过，后端自动去请求

[simman]

http://apidocjs.com ，你值得拥有~~~

[simman]

不好意思，昨晚加班眼睛不好用，没看清是 json

[laotan88]

团队在用，推广下
http://thx.github.io/RAP/

[mornlight]

8楼说的RAP 可以，阿里开源的，我也在用

[pheyer]

@janxin 网站打开很慢很慢

[pheyer]

@laotan88 不知道怎么跑起来，不会java，eclipse中运行总是出错……

[mornlight]

@pheyer 不不不，你不需要编译运行，你只需要下载release 分支里的war包
https://github.com/thx/RAP/tree/release/release

[hujianxincom]

有为个 iodoc的东西，可以按照 JSON 生成指定 的APIDEMO

[xmbaozi]

我写过php。把常用的自动写个映射，没用到的再人工补充，很快

[pheyer]

@mornlight 果然，好吧，白白浪费了那么多的时间

[juxingzhutou]

天天去跟负责接口的同事吵，我的接口列表就是这么来的。

[yafeilee]

@pheyer 虽说这里是 php 节点, 我还是推荐下Rails 下的 lina: https://linarb.org

可以根据 API 约束自动生成 APIDOC. PHP 界也许也可以弄一个出来.

[yafeilee]

@pheyer 地址多了一个 s, http://linarb.org/

[pheyer]

@yafeilee 这个不能从JSON导入生成APIDOC吧？我是做iOS开发的这接口文档本来应该是别人给我的