Aikaterini Karavasileiou, "An ontology for describing OpenAPI Version 3.0 services in the cloud", Diploma Work, School of Electrical and Computer Engineering, Technical University of Crete, Chania, Greece, 2019
https://doi.org/10.26233/heallink.tuc.83891
Cloud services are mainly offered by means of Web services based on the REST architecture style and need to be formally described in a way that is both understandable by humans and machines. In this work, we adopt the OpenAPI Specification (OAS), a simple and yet powerful specification for the description of REST APIs, as the description language of Cloud services. OAS descriptionsare mainly understandable by humans. However, OAS descriptions must be also understandable by machines so that, the services can be searched, discovered and used by other services. In order for a machine to understand the meaning of OAS, service descriptions need to be formally defined and their content to be semantically enriched in a way that eliminates ambiguities. Taking advantage of the extension features foreseen in OAS 3.0, our approach suggests that in order to eliminate ambiguities in OAS descriptions, OAS properties must be semantically annotated. Building-upon the latest version of OAS, this work proposes Semantic OAS (SOAS 3.0). Building-upon SOAS descriptions, we designed and implemented a mechanism to transform SOAS (and therefore OAS) descriptions to ontologies. As a result, the ontology will enable application of querying languages (e.g. SPARQL) for service discovery and of reasoning tools for detecting inconsistencies and inferred relationships in SOAS descriptions.