如何從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草案。