Skip to main content

Survey of Semantic Description of REST APIs

  • Chapter
  • First Online:
REST: Advanced Research Topics and Practical Applications

Abstract

The REST architectural style assumes that client and server form a contract with content negotiation, not only on the data format but implicitly also on the semantics of the communicated data, i.e., an agreement on how the data have to be interpreted [247]. In different application scenarios such an agreement requires vendor-specific content types for the individual services to convey the meaning of the communicated data. The idea behind vendor-specific content types is that service providers can reuse content types and service consumers can make use of specific processors for the individual content types. In practice however, we see that many RESTful APIs on the Web simply make use of standard non-specific content types, e.g., text/xml or application/json [150]. Since the agreement on the semantics is only implicit, programmers developing client applications have to manually gain a deep understanding of several APIs from multiple providers.

* The bibliography that accompanies this chapter appears at the end of this volume and is also available as a free download as Back Matter on SpringerLink, with online reference linking.

This is a preview of subscription content, log in via an institution to check access.

Access this chapter

Subscribe and save

Springer+ Basic
EUR 32.99 /Month
  • Get 10 units per month
  • Download Article/Chapter or Ebook
  • 1 Unit = 1 Article or 1 Chapter
  • Cancel anytime
Subscribe now

Buy Now

Chapter
USD 29.95
Price excludes VAT (USA)
  • Available as PDF
  • Read on any device
  • Instant download
  • Own it forever
eBook
USD 84.99
Price excludes VAT (USA)
  • Available as EPUB and PDF
  • Read on any device
  • Instant download
  • Own it forever
Softcover Book
USD 109.99
Price excludes VAT (USA)
  • Compact, lightweight edition
  • Dispatched in 3 to 5 business days
  • Free shipping worldwide - see info
Hardcover Book
USD 109.99
Price excludes VAT (USA)
  • Durable hardcover edition
  • Dispatched in 3 to 5 business days
  • Free shipping worldwide - see info

Tax calculation will be finalised at checkout

Purchases are for personal use only

Institutional subscriptions

Similar content being viewed by others

Notes

  1. 1.

    For example, the Twitter REST API: http://dev.twitter.com/docs/api

  2. 2.

    A large archive of WADL descriptions is available on GitHub: http://github.com/apigee/wadl-library

  3. 3.

    http://martinfowler.com/articles/richardsonMaturityModel.html

  4. 4.

    Search done on October 5th, 2009

  5. 5.

    http://delicious.com/

  6. 6.

    http://search.yahoo.com/

  7. 7.

    http://microformats.org/wiki/microformats-2#backward_compatible

  8. 8.

    http://www.wst.univie.ac.at/workgroups/sem-nessi/index.php?t=semanticweb

  9. 9.

    http://www.wsmo.org/ns/rosm/0.1/

  10. 10.

    http://www.servface.eu/

  11. 11.

    http://sswap.info/

  12. 12.

    http://sioc-project.org/ontology/

  13. 13.

    http://www.isi.edu/integration/karma

  14. 14.

    http://isi.edu/integration/karma/ontologies/model/current#

  15. 15.

    Semantic Web Rule Language: http://www.w3.org/Submission/SWRL

  16. 16.

    http://purl.org/hrests/current#

  17. 17.

    http://www.w3.org/Submission/WSMO-Lite

  18. 18.

    http://github.com/InformationIntegrationGroup/Web-Karma-Public

  19. 19.

    http://sweet.kmi.open.ac.uk

  20. 20.

    http://sweet.kmi.open.ac.uk

  21. 21.

    http://extjs.com/products/gxt/

  22. 22.

    SOA4Alleu project fp7 - 215219, http://soa4all.eu/

  23. 23.

    http://sweetdemo.kmi.open.ac.uk/soa4all/MicroWSMOeditor.html

  24. 24.

    Web applications that combine data from multiple sources to create new services, many of them listed in [64].

  25. 25.

    First documented appearance of JSON-P in Bob Ippolito’s December 2005 blog post: http://bob.ippoli.to/archives/2005/12/05/remote-json-jsonp/.

  26. 26.

    http://enable-cors.org/

  27. 27.

    http://technav.ieee.org/tag/2585/authentication

  28. 28.

    http://oauth.net/

  29. 29.

    http://www.duke.edu/~rob/kerberos/authvauth.html

Acknowledgments

R. Verborgh and R. Van de Walle are funded by Ghent University, the Interdisciplinary Institute for Broadband Technology (iMinds), the Institute for the Promotion of Innovation by Science and Technology in Flanders (iwt), the Fund for Scientific Research Flanders (fwo Flanders), and the European Union. A. Harth and S. Speiser acknowledge the support of the European Commission’s Seventh Framework Programme FP7/2007-2013 (PlanetData, Grant 257641). S. Stadtmüller has been supported by a Software Campus grant.

Author information

Authors and Affiliations

Authors

Corresponding author

Correspondence to Ruben Verborgh .

Editor information

Editors and Affiliations

Rights and permissions

Reprints and permissions

Copyright information

© 2014 Springer Science+Business Media New York

About this chapter

Cite this chapter

Verborgh, R. et al. (2014). Survey of Semantic Description of REST APIs. In: Pautasso, C., Wilde, E., Alarcon, R. (eds) REST: Advanced Research Topics and Practical Applications. Springer, New York, NY. https://doi.org/10.1007/978-1-4614-9299-3_5

Download citation

  • DOI: https://doi.org/10.1007/978-1-4614-9299-3_5

  • Published:

  • Publisher Name: Springer, New York, NY

  • Print ISBN: 978-1-4614-9298-6

  • Online ISBN: 978-1-4614-9299-3

  • eBook Packages: EngineeringEngineering (R0)

Publish with us

Policies and ethics