如何从REST Web服务读取规范

Question

我需要创建一个包含以下内容的项目：读取其余Web服务的规范（合同，文档，信息），它们的方法是什么，返回类型，参数方法等...但是我看到并非所有实现WSDL SOAP之类的规范。

怎么做？

Answer 1

格式json-home已设计为一种格式，可帮助在运行时发现API中可用的资源。 还有其他格式，例如Swagger，WADL，RAML，Api Blueprint，可用于描述API。 但是，为了确保客户端和服务器保持松散耦合，这些规范应仅在运行时使用，而不能在设计时由客户端使用。

Answer 2

有标准的WADL，新兴的RSDL，API托管设施可以实现自己的文档标准（RAML-Mule，Api Blueprint-apiary.io），而Swagger会生成API列表。 没有每个人都可以实现的通用标准。 如果您的规范要求您能够全部阅读，则可以设置优先级并检查每种类型的文档，然后首先解析首选格式。

如果这些是公司服务，则您可以控制服务器端，并可以迫使提供者实施易于使用的WADL或swagger（wadl2jave或swagger的json列表）。

注意：另一个答案中提到的http://tools.ietf.org/html/draft-nottingham-json-home-02是过期的IETF草案。