描述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

回答