Musyaffa, Fathoni A.Fathoni A.MusyaffaHalilaj, LavdimLavdimHalilajSiebes, R.R.SiebesOrlandi, FabrizioFabrizioOrlandiAuer, SörenSörenAuer2022-03-132022-03-132016https://publica.fraunhofer.de/handle/publica/39569710.1109/ICWS.2016.93Unification 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.en005conference paper