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