描述REST服務

如何描述一個生成JSON響應的非常簡單的REST服務，最標準化的形式是什麼？什麼是WSDL的XML（但這裏WSDL將是一個明顯的矯枉過正，而不是推薦）。描述REST服務

請參閱[Web應用程序描述語言]（http://en.wikipedia.org/wiki/Web_Application_Description_Language）（WADL） –

我聽說'WADL'不是兩者都很合適。 – Cartesius00

多年來我聽到很多東西。我不相信他們全部。你爲什麼將WADL描述爲不合適（或者你在哪裏閱讀過）？ IME，對於簡單的REST服務來說很好，一旦你變得非常複雜，就會變得麻煩，但是YMMV在這裏。 –

來自REST服務的響應應該是自描述的，因此具有單獨的描述文檔將是多餘的。

2012-01-25 12:35:28

即使爲每個JSON對象響應添加「description」成員也可能會有很長的路要走。 – fumanchu

我不認爲有一個。根據REST愛好者的說法，REST缺乏WSDL風格的服務描述是一個特性（更簡單），或者是一個主要缺點（根據SOAP粉絲）。

2012-01-25 10:52:28

最近相當於我所知道的是WADL

2012-01-25 13:46:41

我碰到這個博客帖子基本上提出使用JSON用於描述RESTful服務來了。認爲它是一個絕妙的主意，並在這裏分享：http://ttezel.github.com/blog/2013/02/23/stop-writing-rest-api-clients/

2013-02-24 21:45:53

回答