Overview of RESTful API Description Languages: Difference between revisions

Revision as of 13:41, 4 November 2015

Revision as of 08:20, 5 November 2015

Line 8:

== Alternatives ==

===Hypertext-driven APIs===

An alternative approach to building RESTful APIs is known under the acronym HATEOAS ([[Hypermedia as the Engine of Application State]]). It this approach, the client software is not written to a static interface description shared through documentation. Instead, the client is given a set of entry points and the API is being discovered dynamically through interaction with these endpoints. HATEOAS was introduced in [[Roy Fielding]]'s doctoral thesis <i>''Architectural Styles and the Design of Network-based Software Architectures</i>''. HATEOAS has been the original vision for RESTful APIs which distinguished them from [[Remote Procedure Call|RPC]] mechanisms.<ref>{{cite web|last1=Fielding|first1=Roy|title=REST APIs must be hypertext-driven|url=http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven|accessdate=4 November 2015}}</ref>

==List of RESTful API DLs==

Line 17 ⟶ 18:

*WSDL

*WADL

*[[Google_Cloud_PlatformGoogle Cloud Platform#Products|Google Cloud Endpoints]]

**URL: https://cloud.google.com/endpoints/, https://developers.google.com/discovery

**developer: [[Google]]

*[[Open Data Protocol]] (OData)

**[[OASIS (organization)|OASIS]] standard<ref>{{cite web|title=OASIS Open Data Protocol (OData) TC |- OASIS|url=https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata}}</ref>

**URL: http://www.odata.org/

**developer: [[Microsoft]]

Line 61 ⟶ 62:

==Comparison of RESTful API DLs==

The community around RESTful API DLs is vibrant{{cncitation needed|date=September 2015}} and the landscape is still changing. According to a presentation by Akana, the most active projects in this area are Swagger, RAML and API Blueprint.<ref name="slideshare.net"/>

{| class="wikitable sortable" style="text-align: center; font-size: 85%; width: auto; table-layout: fixed;"

Line 130 ⟶ 131:

[[Category:Cloud standards]]

[[Category:Software architecture]]

{{software-stub}}