Annotated OpenAPI Descriptions and Ontology for REST Services
Νικόλαος Μάινας, Fotios Bouraimis, Aikaterini Karavisileiou, Euripides G. M. Petrakis · International Journal of Artificial Intelligence Tools · 2022
Leveraging the latest research results on hypermedia-driven Web APIs and the newest update of the OpenAPI Specification, we propose a reference ontology for REST services along with a formal procedure for converting OpenAPI service descriptions to instances of this ontology. At the heart of the approach is a model for enhancing the meaning of Schema properties (i.e. re-usable JSON Schema properties that clarify the meaning of service components). Schema properties are semantically annotated (i.e. their meaning is mapped to a semantic model) and existing properties are combined to form composed or polymorphic expressions. The algorithm for mapping service descriptions to the OpenAPI ontology is implemented and is available as a Web Application.