Fotios Bouraimis, "Instantiating OpenAPI descriptions to the REST services ontology", Diploma Work, School of Electrical and Computer Engineering, Technical University of Crete, Chania, Greece, 2021
https://doi.org/10.26233/heallink.tuc.88861
The increasing interest in Web Service architectures over the past years has led to the proliferation of Web Service offerings over the internet. Consequently, the need for efficient and accurate service discovery based on user needs has become a significant challenge. In order for services to become understandable and discoverable by humans and machines they need to be formally described. In this work, we use the OpenAPI Specification (OAS), a widely used specification for the description of REST APIs. OpenAPI descriptions are mainly understandable by humans. However, OpenAPI descriptions need to 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 OpenAPI, service descriptions need to be formally defined and their content be semantically enriched in a way that eliminates ambiguities. Taking into consideration the advantages of OpenAPI 3.0, our approach suggests that in order to eliminate ambiguities in OpenAPI descriptions, OpenAPI properties must be semantically annotated. Building-upon the latest version of OpenAPI and taking advantage of Semantic OpenAPI (SOAS 3.0) this work provides a complete mechanism to transform OpenAPI descriptions to ontologies. As a result, the ontology will make service discovery possible with the application of query languages (e.g., SPARQL) and reasoning tools for detecting inconsistencies and inferred relationships in SOAS descriptions.