是否有工具在文档中定义Rest API？

关于为html文档生成Rest API的许多问题.

但鸡蛋来自鸡肉.

在许多情况下,架构需要定义API.这是Web开发人员和iOS / Android客户端开发人员之间的联系.

那么有这样的工具或网络,我们可以做的事情：

新的API
写subURL
编写POST / GET方法
写帖子参数
写回复的答案
写样本请求,任何条件,错误代码.
毕竟,有一个doc或Online doc html.

我们可以编辑,经过一段时间后更新它.网络/客户端开发人员,只需要观看文档,然后他们就可以开始了.

有什么样的工具可以存档吗？谢谢.

解决方法

有一些文档规范允许客户端发现RESTful API.

> Swagger(demo)
> apiary
> JSON Home
> Google使用他们自己的Discovery Service,但与其他人不同,遗憾的是我不认为有开源库可以帮助您使用自己的API公开它.

我使用了招摇,它运作良好.规范处理你提到的事情：

>用于描述请求/响应的JSON模式
>错误代码/条件列表
> codegen library为Javascript,Java,Objective-C,Scala,PHP,Python,Ruby等多种语言生成客户端代码.