In recent years several description tools and formats have been introduced for describing REST Web APIs both in human and machine readable formats. Although these descriptions provide functional information about the APIs (e.g. HTTP methods, URIs, model schema, etc.), the information that qualifies the properties of APIs (e.g. classification of input arguments and response data) is missing. We envisage that providing a complete set of information to the users will facilitate the composition of APIs to fulfil users’ specific needs. This paper analyses the current state of the art in Web API Descriptions and Semantic Annotations to show that although there are solutions with semantic capabilities, most of them fails to add semantic annotations automatically or semi-automatically. Moreover, advanced technical skills are needed to manage semantics and compose different Web APIs, which reduce the number of potential users of such solutions. The goal is to enhance actual API descriptions by creating a simple description format to annotate properties at semantic level to support semi-automatic composition. To achieve this goal, we propose an extension of the Open API Initiative (OAI) specification to create comprehensive descriptions. The approach focuses on the emerging concept of API Profiling to add descriptive information of data semantics by addressing Dublin Core Application Profile (DCAP) guidelines.

Lucky, M., Cremaschi, M., Lodigiani, B., Menolascina, A., DE PAOLI, F. (2016). Enriching API descriptions by adding API profiles through semantic annotation. In Service-Oriented Computing (pp.780-794). Springer Verlag [10.1007/978-3-319-46295-0_55].

Enriching API descriptions by adding API profiles through semantic annotation

LUCKY, MEHERUN NESA
Primo
;
CREMASCHI, MARCO
;
DE PAOLI, FLAVIO MARIA
Ultimo
2016

Abstract

In recent years several description tools and formats have been introduced for describing REST Web APIs both in human and machine readable formats. Although these descriptions provide functional information about the APIs (e.g. HTTP methods, URIs, model schema, etc.), the information that qualifies the properties of APIs (e.g. classification of input arguments and response data) is missing. We envisage that providing a complete set of information to the users will facilitate the composition of APIs to fulfil users’ specific needs. This paper analyses the current state of the art in Web API Descriptions and Semantic Annotations to show that although there are solutions with semantic capabilities, most of them fails to add semantic annotations automatically or semi-automatically. Moreover, advanced technical skills are needed to manage semantics and compose different Web APIs, which reduce the number of potential users of such solutions. The goal is to enhance actual API descriptions by creating a simple description format to annotate properties at semantic level to support semi-automatic composition. To achieve this goal, we propose an extension of the Open API Initiative (OAI) specification to create comprehensive descriptions. The approach focuses on the emerging concept of API Profiling to add descriptive information of data semantics by addressing Dublin Core Application Profile (DCAP) guidelines.
paper
Theoretical Computer Science; Computer Science (all), Web Services, semantic web, matchmaking, API decription
English
14th International Conference on Service-Oriented Computing, ICSOC 2016
2016
Service-Oriented Computing
9783319462943
2016
9936
780
794
http://springerlink.com/content/0302-9743/copyright/2005/
reserved
Lucky, M., Cremaschi, M., Lodigiani, B., Menolascina, A., DE PAOLI, F. (2016). Enriching API descriptions by adding API profiles through semantic annotation. In Service-Oriented Computing (pp.780-794). Springer Verlag [10.1007/978-3-319-46295-0_55].
File in questo prodotto:
File Dimensione Formato  
ICSOC2016.pdf

Solo gestori archivio

Tipologia di allegato: Publisher’s Version (Version of Record, VoR)
Dimensione 1.38 MB
Formato Adobe PDF
1.38 MB Adobe PDF   Visualizza/Apri   Richiedi una copia

I documenti in IRIS sono protetti da copyright e tutti i diritti sono riservati, salvo diversa indicazione.

Utilizza questo identificativo per citare o creare un link a questo documento: https://hdl.handle.net/10281/137237
Citazioni
  • Scopus 18
  • ???jsp.display-item.citation.isi??? 15
Social impact