web-services – 机器可读格式的REST服务示例

前端之家收集整理的这篇文章主要介绍了web-services – 机器可读格式的REST服务示例前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我看到的大多数REST接口都是用一个描述URL,方法,接受的输入和返回结果的简单网页来描述的.例如 Amazon S3Twitter API文档.

人类可读对于亚马逊或Twitter来说显然已经足够好了.但是有没有公司以机器可读的格式描述REST API?如果是的话,哪些?

WSDL 2.0声明是capable of describing REST. WADL是为描述REST服务而显式创建的. WSDL 2.0和WADL似乎都有一个相当小的跟随atm,它似乎是创建和维护描述文档的努力的回报.通过识别现实生活中的例子,基本上可以验证或否定这一假设.

您是否使用WSDL / WADL来描述您的服务?您是否依赖WSDL / WADL来消费他人的服务?您的选择工具目前是否支持?是否有可以使用的广泛使用的REST服务示例,这些示例以机器可读格式详细说明?

解决方法

是的你应该.您将能够使用一组支持WADL的工具生成客户端代码,测试和文档.一些例子可以找到 here.另外,我认为你应该坚持使用WADL,而不是WSDL 2.0,因为它不那么冗长,而且更简单(恕我直言).实际上,在WADL中,您只需使用WADL XML语法就可以准确描述用户在文档页面上看到的内容. BTW,这就是为WADL编写基于XSLT的文档生成器这么容易的原因.
原文链接:https://www.f2er.com/html/226738.html

猜你在找的HTML相关文章