我看到的大多数REST接口都是用一个描述URL,方法,接受的输入和返回结果的简单网页来描述的.例如Amazon S3或Twitter API文档.
人类可读对于亚马逊或Twitter来说显然已经足够好了.但是有没有公司以机器可读的格式描述REST API?如果是的话,哪些?
WSDL 2.0声明能够描述REST.显式创建WADL用于描述REST服务.WSDL 2.0和WADL似乎都有一个相当小的跟随atm,它似乎是创建和维护描述文档的努力的回报.通过识别现实生活中的例子,基本上可以验证或否定这一假设.
您是否使用WSDL/WADL来描述您的服务?您是否依赖WSDL/WADL来消费他人的服务?您的选择工具目前是否支持?是否有可以使用的广泛使用的REST服务示例,这些示例以机器可读格式详细说明?