RESTful Services with Lightweight Machine-readable Descriptions and Semantic Annotations

  • Jacek KopeckýEmail author
  • Tomas Vitvar
  • Carlos Pedrinaci
  • Maria Maleshkova


REST was originally developed as the architectural foundation for the human-oriented Web, but it has turned out to be a useful architectural style for machine-to-machine distributed systems as well. The most prominent wave of machine-oriented RESTful systems are Web APIs (also known as RESTful services), provided by Web sites such as Facebook, Flickr, and Amazon to facilitate access to the services from programmatic clients, including other Web sites. Currently, Web APIs do not commonly provide machine-processable service descriptions which would help tool support and even some degree of automation on the client side. This chapter presents current research on lightweight service description for Web APIs, building on the HTML documentation that accompanies the APIs. descriptions. HTML documentation can be annotated with a microformat that captures a minimal machine-oriented service model, or with RDFa using the RDF representation of the same service model. Machine-oriented descriptions (now embedded in the HTML documentation of Web APIs) can also capture the semantics of Web APIs and thus support further automation for clients. The chapter includes a discussion of various types and degrees of tool support and automation possible using the lightweight service descriptions.


Service Composition Service Model Service Description Semantic Annotation Service Semantic 
These keywords were added by machine and not by the authors. This process is experimental and the keywords may be updated as the learning algorithm improves.



The authors would like to thank Dr. Karthik Gomadam for collaboration on the hRESTS microformat. Much of the work presented in this chapter has been supported by the European Union research project SOA4All


  1. Akhtar, W., Kopecký, J., Krennwallner, T., Polleres, A.: XSPARQL: Traveling between the XML and RDF worlds – and avoiding the XSLT pilgrimage. In: S. Bechhofer, M. Koubarakis (eds.) The Semantic Web: Research and Applications, 5th European Semantic Web Conference, ESWC 2008, Lecture Notes in Computer Science, LNCS, vol. 5021, pp. 674–689. Springer, Tenerife, Spain (2008)Google Scholar
  2. Akkiraju, R., Farrell, J., Miller, J., Nagarajan, M., Schmidt, M., Sheth, A., Verma, K.: Web Service Semantics – WSDL-S. Technical note (2005). Available at
  3. Architecture of the World Wide Web. Recommendation, W3C (2004). Available at
  4. Bizer, C., Heath, T., Berners-Lee, T.: Linked Data - The Story So Far. International Journal on Semantic Web and Information Systems (IJSWIS), Special Issue on Linked Data (2009)Google Scholar
  5. Fensel, D., Fischer, F., Kopecký, J., Krummenacher, R., Lambert, D., Vitvar, T.: WSMO-Lite: Lightweight Semantic Descriptions for Services on the Web (2010). URL W3C member submission, available at
  6. Gleaning Resource Descriptions from Dialects of Languages (GRDDL). Recommendation, W3C (2007). Available at
  7. Hoffmann, J., Weber, I., Scicluna, J., Kaczmarek, T., Ankolekar, A.: Combining Scalability and Expressivity in the Automatic Composition of Semantic Web Services. In: Proceedings of the 8th International Conference on Web Engineering (ICWE’08). Yorktown Heights, USA (2008)Google Scholar
  8. Horrocks, I., Patel-Schneider, P.F., Boley, H., Tabet, S., Grosof, B., Dean, M.: SWRL: A Semantic Web Rule Language Combining OWL and RuleML. Tech. rep., Joint US/EU ad hoc Agent Markup Language Committee (2003). Available at
  9. HTML 4.01 Specification. Recommendation, W3C (1999). Available at
  10. Khare, R., Çelik, T.: Microformats: a pragmatic path to the semantic web (Poster). Proceedings of the 15th international conference on World Wide Web pp. 865–866 (2006)Google Scholar
  11. OWL Web Ontology Language Overview. Recommendation 10 February 2004, W3C (2004). Available at
  12. OWL-S 1.1 Release. Tech. rep., OWL Services Coalition (2004). Available at
  13. RDFa in XHTML: Syntax and Processing. Recommendation, W3C (2008). Available at
  14. Richardson, L., Ruby, S.: RESTful Web Services. O’Reilly Media (2007)Google Scholar
  15. RIF Core Dialect. Recommendation, W3C (2010). Available at
  16. Semantic Annotations for WSDL and XML Schema. Recommendation, W3C (2007). Available at
  17. Sheth, A.P.: Semantic Web Process Lifecycle: Role of Semantics in Annotation, Discovery, Composition and Orchestration (2003). Invited Talk, Workshop on E-Services and the Semantic Web, at WWW 2003. Available at
  18. Sheth, A.P., Gomadam, K., Lathem, J.: SA-REST: Semantically Interoperable and Easier-to-Use Services and Mashups. IEEE Internet Computing 11(6), 91–94 (2007)CrossRefGoogle Scholar
  19. Skoutas, D., Sacharidis, D., Simitsis, A., Sellis, T.: Serving the Sky: Discovering and Selecting Semantic Web Services through Dynamic Skyline Queries. In: Proceedings of the 2008 IEEE International Conference on Semantic Computing. Santa Clara, USA (2008)Google Scholar
  20. Sycara, K., Paolucci, M., Ankolekar, A., Srinivasan, N.: Automated discovery, interaction and composition of Semantic Web services. Web Semantics: Science, Services and Agents on the World Wide Web 1(1), 27–46 (2003)CrossRefGoogle Scholar
  21. The Web Service Modeling Language WSML. Tech. rep., WSMO Working Group (2008). Available at
  22. Web Services Description Language (WSDL) Version 2.0: Adjuncts. Recommendation, W3C (2007). Available at
  23. XML Path Language (XPath) Version 1.0. Recommendation, W3C (2009). Available at

Copyright information

© Springer Science+Business Media, LLC 2011

Authors and Affiliations

  • Jacek Kopecký
    • 1
    Email author
  • Tomas Vitvar
    • 2
  • Carlos Pedrinaci
    • 1
  • Maria Maleshkova
    • 1
  1. 1.Knowledge Media InstituteOpen UniversityMilton KeynesUK
  2. 2.Institut für InformatikUniversity of InnsbruckInnsbruckAustria

Personalised recommendations