short-paper

Declaratively Describing Responses of Hypermedia-Driven Web APIs

Authors:

Ruben VerborghAuthors Info & Claims

K-CAP '17: Proceedings of the 9th Knowledge Capture Conference

Article No.: 34, Pages 1 - 4

https://doi.org/10.1145/3148011.3154467

Published: 04 December 2017 Publication History

Abstract

While humans browse the Web by following links, these hypermedia links can also be used by machines for browsing. While efforts such as Hydra semantically describe the hypermedia controls on Web interfaces to enable smarter interface-agnostic clients, they are largely limited to the input parameters to interfaces, and clients therefore do not know what response to expect from these interfaces. In order to convey such expectations, interfaces need to declaratively describe the response structure of their parameterized hypermedia controls. We therefore explored techniques to represent this parameterized response structure in a generic but expressive way. In this work, we discuss four different approaches for declaring a response structure, and we compare them based on a model that we introduce. Based on this model, we conclude that a SHACL shape-based approach can be used for declaring such a parameterized response structure, as it conforms to the REST architectural style that has helped shape the Web into its current form.

References

[1]

Fielding, R.T., Taylor, R.N.: Architectural styles and the design of network-based software architectures. University of California, Irvine Doctoral dissertation (2000).

Digital Library

[2]

Bizer, C., Heath, T., Berners-Lee, T.: Linked Data - the story so far. Semantic Services, Interoperability and Web Applications: Emerging Concepts. 205--227 (2009).

[3]

Cyganiak, R., Wood, D., Lanthaler, M.: RDF 1.1: Concepts and Abstract Syntax. W3C, http://www.w3.org/TR/2014/REC-rdf11-concepts-20140225/ (2014).

[4]

Amundsen, M.: Hypermedia Types. In: REST: From Research to Practice. pp. 93--116. Springer (2011).

[5]

Lanthaler, M., Gütl, C.: Hydra: A Vocabulary for Hypermedia-Driven Web APIs. LDOW. 996, (2013).

[6]

Verborgh, R., Vander Sande, M., Hartig, O., Van Herwegen, J., De Vocht, L., De Meester, B., Haesendonck, G., Colpaert, P.: Triple Pattern Fragments: a Low-cost Knowledge Graph Interface for the Web. Journal of Web Semantics. 37--38, (2016).

Digital Library

[7]

Knublauch, H., Kontokostas, D.: Shapes Constraint Language (SHACL). W3C, https://www.w3.org/TR/2017/REC-shacl-20170720/ (2017).

[8]

Knublauch, H.: SPIN - Modeling Vocabulary. W3C Member Submission. 22, (2011).

[9]

Group, W.C.O.W.L.W.: OWL 2 Web Ontology Language. W3C, https://www.w3.org/TR/2012/REC-owl2-overview-20121211/ (2012).

[10]

Martin, D., Burstein, M., Hobbs, J., Lassila, O., McDermott, D., McIlraith, S., Narayanan, S., Paolucci, M., Parsia, B., Payne, T., others: OWL-S: Semantic markup for web services. W3C, https://www.w3.org/Submission/owl-s/ (2004).

[11]

Verborgh, R., Dumontier, M.: A Web API ecosystem through feature-based reuse. CoRR. abs/1609.07108, (2016).

[12]

Brickley, D., Guha, R.V.: RDF Schema 1.1. W3C, https://www.w3.org/TR/2014/REC-rdf-schema-20140225/ (2004).

[13]

Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., Berners-Lee, T.: Hypertext transfer protocol -- HTTP/1.1. https://www.w3.org/Protocols/rfc2616/rfc2616.html (1999).

Digital Library

[14]

Freed, N., Klensin, J., Hansen, T.: Media type specifications and registration procedures. https://tools.ietf.org/html/rfc6838 (2013).

[15]

Harris, S., Seaborne, A., Prud'hommeaux, E.: SPARQL 1.1 Query Language. W3C, http://www.w3.org/TR/2013/REC-sparql11-query-20130321/ (2013).

[16]

Hyland, B., Atemezing, G., Villazón-Terrazas, B.: Best Practices for Publishing Linked Data. W3C, https://www.w3.org/TR/2014/NOTE-ld-bp-20140109/ (2014).

[17]

Dataset Exchange Working Group (DXWG). https://www.w3.org/2017/dxwg/wiki/Main_Page (2017).

Cited By

Bennara MZimmermann ALefrançois MMessalti N(2020)Interoperability of Semantically-Enabled Web Services on the WoTProceedings of the 22nd International Conference on Information Integration and Web-based Applications & Services10.1145/3428757.3429199(149-153)Online publication date: 30-Nov-2020
https://dl.acm.org/doi/10.1145/3428757.3429199
Taelman RVan Herwegen JVander Sande MVerborgh R(2018)Comunica: A Modular SPARQL Query Engine for the WebThe Semantic Web – ISWC 201810.1007/978-3-030-00668-6_15(239-255)Online publication date: 18-Sep-2018
https://doi.org/10.1007/978-3-030-00668-6_15

Index Terms

Declaratively Describing Responses of Hypermedia-Driven Web APIs
1. Information systems
  1. World Wide Web

Recommendations

Creating 3rd generation web APIs with hydra
WWW '13 Companion: Proceedings of the 22nd International Conference on World Wide Web

In this paper we describe a novel approach to build hypermedia-driven Web APIs based on Linked Data technologies such as JSON-LD. We also present the result of implementing a first prototype featuring both a RESTful Web API and a generic API client. To ...
Functional descriptions as the bridge between hypermedia APIs and the Semantic Web
WS-REST '12: Proceedings of the Third International Workshop on RESTful Design

The early visions for the Semantic Web, from the famous 2001 Scientific American article by Berners-Lee et al., feature intelligent agents that can autonomously perform tasks like discovering information, scheduling events, finding execution plans for ...
Using the relation ontology Metarel for modelling Linked Data as multi-digraphs
Linked Data for Health Care and the Life Sciences

The Semantic Web standards OWL and RDF are often used to represent biomedical information as Linked Data; however, the OWL/RDF syntax, which combines both, was never optimised for querying. By combining two formal paradigms for modelling Linked Data, ...

Comments

Please enable JavaScript to view thecomments powered by Disqus.

Information & Contributors

Information

Published In

cover image ACM Conferences

K-CAP '17: Proceedings of the 9th Knowledge Capture Conference

December 2017

271 pages

ISBN:9781450355537

DOI:10.1145/3148011

Copyright © 2017 ACM.

Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than the author(s) must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected].

Sponsors

SIGAI: ACM Special Interest Group on Artificial Intelligence

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 04 December 2017

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Short-paper
Research
Refereed limited

Conference

K-CAP 2017

Sponsor:

SIGAI

K-CAP 2017: Knowledge Capture Conference

December 4 - 6, 2017

TX, Austin, USA

Acceptance Rates

Overall Acceptance Rate 55 of 198 submissions, 28%

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

2
Total Citations
View Citations
76
Total Downloads

Downloads (Last 12 months)3
Downloads (Last 6 weeks)0

Reflects downloads up to 26 Sep 2024

Other Metrics

View Author Metrics

Citations

Cited By

Bennara MZimmermann ALefrançois MMessalti N(2020)Interoperability of Semantically-Enabled Web Services on the WoTProceedings of the 22nd International Conference on Information Integration and Web-based Applications & Services10.1145/3428757.3429199(149-153)Online publication date: 30-Nov-2020
https://dl.acm.org/doi/10.1145/3428757.3429199
Taelman RVan Herwegen JVander Sande MVerborgh R(2018)Comunica: A Modular SPARQL Query Engine for the WebThe Semantic Web – ISWC 201810.1007/978-3-030-00668-6_15(239-255)Online publication date: 18-Sep-2018
https://doi.org/10.1007/978-3-030-00668-6_15

View Options

Get Access

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Full Access

Get this Publication

View options

PDF

View or Download as a PDF file.

eReader

View online with eReader.

Media

Figures

Other

Tables

View Table of Contents