Minimally invasive semantification of light weight service descriptions

Fathoni A. Musyaffa; Lavdim Halilaj; Ronald Siebes; Fabrizio Orlandi; Soren Auer

doi:10.1109/ICWS.2016.93

Minimally invasive semantification of light weight service descriptions

Fathoni A. Musyaffa
, Lavdim Halilaj
, Ronald Siebes
, Fabrizio Orlandi
, Soren Auer

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

5 Downloads (Pure)

Abstract

Unification and automation of RESTful web services' documentation and descriptions is currently receiving increasing attention. The open-source OpenAPI Specification (formerly known as Swagger) has become core of this effort and has been adopted by a number of major companies. It allows the description of RESTful web services using objects represented in JSON or YAML file formats. As a result, the created descriptions are human and machine-readable, but not machine-understandable. In this paper, we propose a nonintrusive approach for the addition of semantic annotations (similar to RDFa and JSON-LD for HTML) to specific fields of the OpenAPI Specification. We created a lightweight vocabulary for describing RESTful web services using this specification. Furthermore, we practically demonstrate how OpenAPI objects can be enriched with semantic descriptions in a minimally invasive way by adding URIs in the values of chosen OpenAPI properties.

Original language	English
Title of host publication	Proceedings - 2016 IEEE International Conference on Web Services, ICWS 2016
Publisher	Institute of Electrical and Electronics Engineers, Inc.
Pages	672-677
Number of pages	6
ISBN (Electronic)	9781509026753
DOIs	https://doi.org/10.1109/ICWS.2016.93
Publication status	Published - 31 Aug 2016
Event	23rd IEEE International Conference on Web Services, ICWS 2016 - San Francisco, United States Duration: 27 Jun 2016 → 2 Jul 2016

Conference

Conference	23rd IEEE International Conference on Web Services, ICWS 2016
Country/Territory	United States
City	San Francisco
Period	27/06/16 → 2/07/16

Funding

Horizon-2020

Keywords

Linked data
OpenAPI
Service interfaces

Access to Document

10.1109/ICWS.2016.93

ICWS2016_paper_10464Accepted author manuscript, 169 KBLicence: Unspecified

Persistent URL (handle)

Persistent link

Cite this

@inproceedings{243dd607f3dd41fb89ca6d0f92189cd9,

title = "Minimally invasive semantification of light weight service descriptions",

abstract = "Unification and automation of RESTful web services' documentation and descriptions is currently receiving increasing attention. The open-source OpenAPI Specification (formerly known as Swagger) has become core of this effort and has been adopted by a number of major companies. It allows the description of RESTful web services using objects represented in JSON or YAML file formats. As a result, the created descriptions are human and machine-readable, but not machine-understandable. In this paper, we propose a nonintrusive approach for the addition of semantic annotations (similar to RDFa and JSON-LD for HTML) to specific fields of the OpenAPI Specification. We created a lightweight vocabulary for describing RESTful web services using this specification. Furthermore, we practically demonstrate how OpenAPI objects can be enriched with semantic descriptions in a minimally invasive way by adding URIs in the values of chosen OpenAPI properties.",

keywords = "Linked data, OpenAPI, Service interfaces",

author = "Musyaffa, \{Fathoni A.\} and Lavdim Halilaj and Ronald Siebes and Fabrizio Orlandi and Soren Auer",

year = "2016",

month = aug,

day = "31",

doi = "10.1109/ICWS.2016.93",

language = "English",

pages = "672--677",

booktitle = "Proceedings - 2016 IEEE International Conference on Web Services, ICWS 2016",

publisher = "Institute of Electrical and Electronics Engineers, Inc.",

note = "23rd IEEE International Conference on Web Services, ICWS 2016 ; Conference date: 27-06-2016 Through 02-07-2016",

}

Musyaffa, FA, Halilaj, L, Siebes, R, Orlandi, F & Auer, S 2016, Minimally invasive semantification of light weight service descriptions. in Proceedings - 2016 IEEE International Conference on Web Services, ICWS 2016., 7558066, Institute of Electrical and Electronics Engineers, Inc., pp. 672-677, 23rd IEEE International Conference on Web Services, ICWS 2016, San Francisco, United States, 27/06/16. https://doi.org/10.1109/ICWS.2016.93

Minimally invasive semantification of light weight service descriptions. / Musyaffa, Fathoni A.; Halilaj, Lavdim; Siebes, Ronald et al.
Proceedings - 2016 IEEE International Conference on Web Services, ICWS 2016. Institute of Electrical and Electronics Engineers, Inc., 2016. p. 672-677 7558066.

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

TY - GEN

T1 - Minimally invasive semantification of light weight service descriptions

AU - Musyaffa, Fathoni A.

AU - Halilaj, Lavdim

AU - Siebes, Ronald

AU - Orlandi, Fabrizio

AU - Auer, Soren

PY - 2016/8/31

Y1 - 2016/8/31

N2 - Unification and automation of RESTful web services' documentation and descriptions is currently receiving increasing attention. The open-source OpenAPI Specification (formerly known as Swagger) has become core of this effort and has been adopted by a number of major companies. It allows the description of RESTful web services using objects represented in JSON or YAML file formats. As a result, the created descriptions are human and machine-readable, but not machine-understandable. In this paper, we propose a nonintrusive approach for the addition of semantic annotations (similar to RDFa and JSON-LD for HTML) to specific fields of the OpenAPI Specification. We created a lightweight vocabulary for describing RESTful web services using this specification. Furthermore, we practically demonstrate how OpenAPI objects can be enriched with semantic descriptions in a minimally invasive way by adding URIs in the values of chosen OpenAPI properties.

AB - Unification and automation of RESTful web services' documentation and descriptions is currently receiving increasing attention. The open-source OpenAPI Specification (formerly known as Swagger) has become core of this effort and has been adopted by a number of major companies. It allows the description of RESTful web services using objects represented in JSON or YAML file formats. As a result, the created descriptions are human and machine-readable, but not machine-understandable. In this paper, we propose a nonintrusive approach for the addition of semantic annotations (similar to RDFa and JSON-LD for HTML) to specific fields of the OpenAPI Specification. We created a lightweight vocabulary for describing RESTful web services using this specification. Furthermore, we practically demonstrate how OpenAPI objects can be enriched with semantic descriptions in a minimally invasive way by adding URIs in the values of chosen OpenAPI properties.

KW - Linked data

KW - OpenAPI

KW - Service interfaces

UR - https://www.scopus.com/pages/publications/84990990595

UR - https://www.scopus.com/pages/publications/84990990595#tab=citedBy

U2 - 10.1109/ICWS.2016.93

DO - 10.1109/ICWS.2016.93

M3 - Conference contribution

AN - SCOPUS:84990990595

SP - 672

EP - 677

BT - Proceedings - 2016 IEEE International Conference on Web Services, ICWS 2016

PB - Institute of Electrical and Electronics Engineers, Inc.

T2 - 23rd IEEE International Conference on Web Services, ICWS 2016

Y2 - 27 June 2016 through 2 July 2016

ER -

Minimally invasive semantification of light weight service descriptions

Abstract

Conference

Funding

Keywords

Access to Document

Persistent URL (handle)

Other files and links

Fingerprint

Cite this