A framework for self-descriptive RESTful services

REST principles define services as resources that can be manipulated by a set of well-known methods. The same approach is suitable to define service descriptions as resources. In this paper, we try to unify the two concepts (services and their descriptions) by proposing a set of best practices to build self-descriptive RESTful services accessible by both humans and machines. Moreover, to make those practices usable with little manual effort, we provide a software framework that extracts compliant descriptions from documents published on the Web, and makes them available to clients as resources.

[1]  Andrea Maurino,et al.  A Meta-model for Non-functional Property Descriptions of Web Services , 2008, 2008 IEEE International Conference on Web Services.

[2]  Gerhard Weikum,et al.  YAGO: A Large Ontology from Wikipedia and WordNet , 2008, J. Web Semant..

[3]  Jens Lehmann,et al.  DBpedia - A crystallization point for the Web of Data , 2009, J. Web Semant..

[4]  Christian Bizer,et al.  DBpedia spotlight: shedding light on the web of documents , 2011, I-Semantics '11.

[5]  Cesare Pautasso,et al.  Restful web services vs. "big"' web services: making the right architectural decision , 2008, WWW.

[6]  Erik Wilde,et al.  From RESTful Services to RDF: Connecting the Web and the Semantic Web , 2010, ArXiv.

[7]  Tom Heath,et al.  Linked Data: Evolving the Web into a Global Data Space , 2011, Linked Data.

[8]  Christian Gütl,et al.  On using JSON-LD to create evolvable RESTful services , 2012, WS-REST.

[9]  Tim Berners-Lee,et al.  Linked data , 2020, Semantic Web for the Working Ontologist.

[10]  Jérôme Euzenat,et al.  Ontology Matching: State of the Art and Future Challenges , 2013, IEEE Transactions on Knowledge and Data Engineering.

[11]  Carlo Batini,et al.  Quality-driven Extraction, Fusion and Matchmaking of Semantic Web API Descriptions , 2012, J. Web Eng..

[12]  Carlo Batini,et al.  PoliMaR-Web: Multi-source Semantic Matchmaking of Web APIs , 2012, WISE.

[13]  Paolo Traverso,et al.  Service-Oriented Computing: a Research Roadmap , 2008, Int. J. Cooperative Inf. Syst..

[14]  Rik Van de Walle,et al.  Functional descriptions as the bridge between hypermedia APIs and the Semantic Web , 2012, WS-REST.

[15]  John Domingue,et al.  Automated Information Extraction from Web APIs Documentation , 2012, WISE.

[16]  Marc J. Hadley,et al.  Web application description language (WADL) , 2006 .

[17]  Roy Fielding,et al.  Architectural Styles and the Design of Network-based Software Architectures"; Doctoral dissertation , 2000 .

[18]  Craig A. Knoblock,et al.  Rapidly Integrating Services into the Linked Data Cloud , 2012, SEMWEB.

[19]  David De Roure,et al.  REST and Linked Data: a match made for domain driven development? , 2011, WS-REST '11.

[20]  Flavio De Paoli,et al.  Distributed matchmaking and ranking of Web APIs exploiting descriptions from Web sources , 2011, 2011 IEEE International Conference on Service-Oriented Computing and Applications (SOCA).

[21]  Steve Vinoski,et al.  Putting the "Web" into Web Services: Interaction Models, Part 2 , 2002, IEEE Internet Comput..

[22]  John Domingue,et al.  Investigating Web APIs on the World Wide Web , 2010, 2010 Eighth IEEE European Conference on Web Services.

[23]  Satoshi Sekine,et al.  A survey of named entity recognition and classification , 2007 .

[24]  Valérie Issarny,et al.  Towards Efficient Matching of Semantic Web Service Capabilities , 2006 .

[25]  Michael Healy,et al.  Theory and Applications of Ontology: Computer Applications , 2010 .

[26]  Roberto Chinnici,et al.  Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language , 2007 .

[27]  Tomas Vitvar,et al.  hRESTS: An HTML Microformat for Describing RESTful Web Services , 2008, 2008 IEEE/WIC/ACM International Conference on Web Intelligence and Intelligent Agent Technology.