如何从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已过期的草案。