title: Description of asynchronous service functionality in the OpenAPI standard
title: Περιγραφή ασύγχρονης λειτουργικότητας υπηρεσιών στο πρότυπο OpenAPI
Creators: name: Ιερωνυμακης Εμμανουηλ-Γεωργιος
Publisher: name: Technical University of Crete
Year: 2024

description: Publishing service descriptions on the web is critical to their discovery and
dissemination in the marketplace. The OpenAPI Specification is a powerful
framework for HTTP(S) and RESTful services, endorsed by the Linux
Foundation and supported by major software vendors such as Google and
Microsoft. OpenAPI comprises a large set of properties for composing service
descriptions. The syntactic binding of OpenAPI format to JSON (or
YAML) complicates the detection of similarities, inconsistencies, or ambiguities
in service descriptions. A previous work introduced, an OpenAPI
Ontology for REST Services that emphasized the mapping of Schema
properties and the ways they are combined with other properties to form
composed or polymorphic expressions in an ontology. This work extends
and integrates previous work efforts on mapping OpenAPI descriptions to
an ontology. It adds new functionality and implements a more efficient
ontology conversion mechanism for mapping complex Schema objects and
the asynchronous features of the latest OpenAPI version (i.e., Links, Webhooks,
and Callbacks). The process has been assessed both qualitatively
and quantitatively. The qualitative evaluation guarantees the structural
and semantic integrity of the ontology. The qualitative evaluation supports
our claim of real-time efficiency for both the ontology mapping and
the query search on a triple-store repository using 10,000 OpenAPI descriptions
downloaded from Swaggerhub.
description: Η δημοσίευση περιγραφών υπηρεσιών στον Ιστό είναι κρίσιμης σημασίας για την ανακάλυψη και την διάδοσή τους στην αγορά. Το πρότυπο OpenAPI είναι ένα ισχυρό Framework για υπηρεσίες HTTP(S) και RESTful, που έχει εγκριθεί από το Linux Foundation και υποστηρίζεται από μεγάλους προμηθευτές λογισμικού όπως η Google και η Microsoft. Το OpenAPI περιλαμβάνει ένα μεγάλο σετ ιδιοτήτων για την σύνταξη περιγραφών υπηρεσιών. Η συντακτική σύνδεση του OpenAPI σε JSON (ή YAML) περιπλέκει τον εντοπισμό ομοιοτήτων, ασυνεπειών ή ασάφειων στις περιγραφές υπηρεσιών. Σε προηγούμενη εργασία παρουσιάστηκε, μία οντολογία OpenAPI για υπηρεσίες REST που έδινε έμφαση στην αντιστοίχιση των ιδιοτήτων των Schema αντικειμένων και στους τρόπους που συνδυάζονται με άλλες ιδιότητες για να σχηματίσουν σύνθετες ή πολυμορφικές εκφράσεις σε μία οντολογία. Αυτή η εργασία επεκτείνει και ενσωματώνει προηγούμενες προσπάθειες εργασιών για την αντιστοίχιση περιγραφών OpenAPI σε μία οντολογία. Προσθέτει νέα λειτουργικότητα και εφαρμόζει έναν πιο αποτελεσματικό μηχανισμό μετατροπής σύνθετων Schema αντικειμένων και των ασύγχρονων  χαρακτηριστικών της τελευταίας έκδοσης OpenAPI (δηλαδή, Links, Webhooks και Callbacks) σε οντολογία. Η εργασία έχει αξιολογηθεί τόσο ποιοτικά όσο και ποσοτικά. Η ποιοτική αξιολόγηση εγγυάται τη δομική και σημασιολογική ακεραιότητα της οντολογίας. Η ποιοτική αξιολόγηση υποστηρίζει τον ισχυρισμό μας για αποτελεσματικότητα σε πραγματικό χρόνο τόσο για την αντιστοίχιση οντολογίας όσο και για την αναζήτηση ερωτημάτων σε ένα triple-store χρησιμοποιώντας 10.000 περιγραφές OpenAPI που έχουν ληφθεί από το Swaggerhub.