SmartAPI: Towards a more intelligent network of web APIs

Amrapali Zaveri; Shima Dastgheib; Chunlei Wu; Trish Whetzel; Ruben Verborgh; Paul Avillach; Gabor Korodi; Raymond Terryn; Kathleen Jagodnik; Pedro Assis; Michel Dumontier

doi:10.1007/978-3-319-58451-5_11

SmartAPI: Towards a more intelligent network of web APIs

Amrapali Zaveri, Shima Dastgheib, Chunlei Wu, Trish Whetzel, Ruben Verborgh, Paul Avillach, Gabor Korodi, Raymond Terryn, Kathleen Jagodnik, Pedro Assis, Michel Dumontier

Research output: Chapter in Book/Report/Conference proceeding › Conference contribution › peer-review

25 Scopus citations

Abstract

Data science increasingly employs cloud-based Web application programming interfaces (APIs). However, automatically discovering and connecting suitable APIs for a given application is difficult due to the lack of explicit knowledge about the structure and datatypes of Web API inputs and outputs. To address this challenge, we conducted a survey to identify the metadata elements that are crucial to the description of Web APIs and subsequently developed the smartAPI metadata specification and associated tools to capture their domain-related and structural characteristics using the FAIR (Findable, Accessible, Interoperable, Reusable) principles. This paper presents the results of the survey, provides an overview of the smartAPI specification and a reference implementation, and discusses use cases of smartAPI. We show that annotating APIs with smartAPI metadata is straightforward through an extension of the existing Swagger editor. By facilitating the creation of such metadata, we increase the automated interoperability of Web APIs. This work is done as part of the NIH Commons Big Data to Knowledge (BD2K) API Interoperability Working Group.

Original language	English
Title of host publication	The Semantic Web - 14th International Conference, ESWC 2017, Proceedings
Editors	Eva Blomqvist, Olaf Hartig, Rinke Hoekstra, Aldo Gangemi, Pascal Hitzler, Diana Maynard
Publisher	Springer Verlag
Pages	154-169
Number of pages	16
ISBN (Print)	9783319584508
DOIs	https://doi.org/10.1007/978-3-319-58451-5_11
State	Published - 2017
Event	14th Extended Semantic Web Conference, ESWC 2017 - Portoroz, Slovenia Duration: 28 May 2017 → 1 Jun 2017

Publication series

Name	Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics)
Volume	10250 LNCS
ISSN (Print)	0302-9743
ISSN (Electronic)	1611-3349

Conference

Conference	14th Extended Semantic Web Conference, ESWC 2017
Country/Territory	Slovenia
City	Portoroz
Period	28/05/17 → 1/06/17

Keywords

FAIR principles
Linked data
Web API
Web API description
Web services

Access to Document

10.1007/978-3-319-58451-5_11

Cite this

Zaveri, A., Dastgheib, S., Wu, C., Whetzel, T., Verborgh, R., Avillach, P., Korodi, G., Terryn, R., Jagodnik, K., Assis, P., & Dumontier, M. (2017). SmartAPI: Towards a more intelligent network of web APIs. In E. Blomqvist, O. Hartig, R. Hoekstra, A. Gangemi, P. Hitzler, & D. Maynard (Eds.), The Semantic Web - 14th International Conference, ESWC 2017, Proceedings (pp. 154-169). (Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics); Vol. 10250 LNCS). Springer Verlag. https://doi.org/10.1007/978-3-319-58451-5_11

Zaveri, Amrapali ; Dastgheib, Shima ; Wu, Chunlei et al. / SmartAPI : Towards a more intelligent network of web APIs. The Semantic Web - 14th International Conference, ESWC 2017, Proceedings. editor / Eva Blomqvist ; Olaf Hartig ; Rinke Hoekstra ; Aldo Gangemi ; Pascal Hitzler ; Diana Maynard. Springer Verlag, 2017. pp. 154-169 (Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics)).

@inproceedings{cb97f9f9a9474842809090808bb49960,

title = "SmartAPI: Towards a more intelligent network of web APIs",

abstract = "Data science increasingly employs cloud-based Web application programming interfaces (APIs). However, automatically discovering and connecting suitable APIs for a given application is difficult due to the lack of explicit knowledge about the structure and datatypes of Web API inputs and outputs. To address this challenge, we conducted a survey to identify the metadata elements that are crucial to the description of Web APIs and subsequently developed the smartAPI metadata specification and associated tools to capture their domain-related and structural characteristics using the FAIR (Findable, Accessible, Interoperable, Reusable) principles. This paper presents the results of the survey, provides an overview of the smartAPI specification and a reference implementation, and discusses use cases of smartAPI. We show that annotating APIs with smartAPI metadata is straightforward through an extension of the existing Swagger editor. By facilitating the creation of such metadata, we increase the automated interoperability of Web APIs. This work is done as part of the NIH Commons Big Data to Knowledge (BD2K) API Interoperability Working Group.",

keywords = "FAIR principles, Linked data, Web API, Web API description, Web services",

author = "Amrapali Zaveri and Shima Dastgheib and Chunlei Wu and Trish Whetzel and Ruben Verborgh and Paul Avillach and Gabor Korodi and Raymond Terryn and Kathleen Jagodnik and Pedro Assis and Michel Dumontier",

note = "Publisher Copyright: {\textcopyright} Springer International Publishing AG 2017.; 14th Extended Semantic Web Conference, ESWC 2017 ; Conference date: 28-05-2017 Through 01-06-2017",

year = "2017",

doi = "10.1007/978-3-319-58451-5_11",

language = "English",

isbn = "9783319584508",

series = "Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics)",

publisher = "Springer Verlag",

pages = "154--169",

editor = "Eva Blomqvist and Olaf Hartig and Rinke Hoekstra and Aldo Gangemi and Pascal Hitzler and Diana Maynard",

booktitle = "The Semantic Web - 14th International Conference, ESWC 2017, Proceedings",

address = "Germany",

}

Zaveri, A, Dastgheib, S, Wu, C, Whetzel, T, Verborgh, R, Avillach, P, Korodi, G, Terryn, R, Jagodnik, K, Assis, P & Dumontier, M 2017, SmartAPI: Towards a more intelligent network of web APIs. in E Blomqvist, O Hartig, R Hoekstra, A Gangemi, P Hitzler & D Maynard (eds), The Semantic Web - 14th International Conference, ESWC 2017, Proceedings. Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics), vol. 10250 LNCS, Springer Verlag, pp. 154-169, 14th Extended Semantic Web Conference, ESWC 2017, Portoroz, Slovenia, 28/05/17. https://doi.org/10.1007/978-3-319-58451-5_11

SmartAPI: Towards a more intelligent network of web APIs. / Zaveri, Amrapali; Dastgheib, Shima; Wu, Chunlei et al.
The Semantic Web - 14th International Conference, ESWC 2017, Proceedings. ed. / Eva Blomqvist; Olaf Hartig; Rinke Hoekstra; Aldo Gangemi; Pascal Hitzler; Diana Maynard. Springer Verlag, 2017. p. 154-169 (Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics); Vol. 10250 LNCS).

Research output: Chapter in Book/Report/Conference proceeding › Conference contribution › peer-review

TY - GEN

T1 - SmartAPI

T2 - 14th Extended Semantic Web Conference, ESWC 2017

AU - Zaveri, Amrapali

AU - Dastgheib, Shima

AU - Wu, Chunlei

AU - Whetzel, Trish

AU - Verborgh, Ruben

AU - Avillach, Paul

AU - Korodi, Gabor

AU - Terryn, Raymond

AU - Jagodnik, Kathleen

AU - Assis, Pedro

AU - Dumontier, Michel

N1 - Publisher Copyright: © Springer International Publishing AG 2017.

PY - 2017

Y1 - 2017

N2 - Data science increasingly employs cloud-based Web application programming interfaces (APIs). However, automatically discovering and connecting suitable APIs for a given application is difficult due to the lack of explicit knowledge about the structure and datatypes of Web API inputs and outputs. To address this challenge, we conducted a survey to identify the metadata elements that are crucial to the description of Web APIs and subsequently developed the smartAPI metadata specification and associated tools to capture their domain-related and structural characteristics using the FAIR (Findable, Accessible, Interoperable, Reusable) principles. This paper presents the results of the survey, provides an overview of the smartAPI specification and a reference implementation, and discusses use cases of smartAPI. We show that annotating APIs with smartAPI metadata is straightforward through an extension of the existing Swagger editor. By facilitating the creation of such metadata, we increase the automated interoperability of Web APIs. This work is done as part of the NIH Commons Big Data to Knowledge (BD2K) API Interoperability Working Group.

AB - Data science increasingly employs cloud-based Web application programming interfaces (APIs). However, automatically discovering and connecting suitable APIs for a given application is difficult due to the lack of explicit knowledge about the structure and datatypes of Web API inputs and outputs. To address this challenge, we conducted a survey to identify the metadata elements that are crucial to the description of Web APIs and subsequently developed the smartAPI metadata specification and associated tools to capture their domain-related and structural characteristics using the FAIR (Findable, Accessible, Interoperable, Reusable) principles. This paper presents the results of the survey, provides an overview of the smartAPI specification and a reference implementation, and discusses use cases of smartAPI. We show that annotating APIs with smartAPI metadata is straightforward through an extension of the existing Swagger editor. By facilitating the creation of such metadata, we increase the automated interoperability of Web APIs. This work is done as part of the NIH Commons Big Data to Knowledge (BD2K) API Interoperability Working Group.

KW - FAIR principles

KW - Linked data

KW - Web API

KW - Web API description

KW - Web services

UR - http://www.scopus.com/inward/record.url?scp=85019617671&partnerID=8YFLogxK

U2 - 10.1007/978-3-319-58451-5_11

DO - 10.1007/978-3-319-58451-5_11

M3 - Conference contribution

AN - SCOPUS:85019617671

SN - 9783319584508

T3 - Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics)

SP - 154

EP - 169

BT - The Semantic Web - 14th International Conference, ESWC 2017, Proceedings

A2 - Blomqvist, Eva

A2 - Hartig, Olaf

A2 - Hoekstra, Rinke

A2 - Gangemi, Aldo

A2 - Hitzler, Pascal

A2 - Maynard, Diana

PB - Springer Verlag

Y2 - 28 May 2017 through 1 June 2017

ER -

Zaveri A, Dastgheib S, Wu C, Whetzel T, Verborgh R, Avillach P et al. SmartAPI: Towards a more intelligent network of web APIs. In Blomqvist E, Hartig O, Hoekstra R, Gangemi A, Hitzler P, Maynard D, editors, The Semantic Web - 14th International Conference, ESWC 2017, Proceedings. Springer Verlag. 2017. p. 154-169. (Lecture Notes in Computer Science (including subseries Lecture Notes in Artificial Intelligence and Lecture Notes in Bioinformatics)). doi: 10.1007/978-3-319-58451-5_11

SmartAPI: Towards a more intelligent network of web APIs

Abstract

Publication series

Conference

Keywords

Access to Document

Fingerprint

Cite this