Skip to main content

Composition and Polymorphism Support in the OpenAPI Ontology

  • Conference paper
  • First Online:
Advanced Information Networking and Applications (AINA 2022)

Abstract

An OpenAPI [5] description details the actions exposed by a REST API. A service is represented by a JSON document describing requests, responses, and security information such as authentication and authorization rules for an API action. Schema objects describe the request and response messages and can be combined to form composite or specialized objects using composed or polymorphic expressions. However, Schema properties can be vague. To clarify their meaning, Schema properties may be associated with a semantic model. Further, to resolve ambiguities in service descriptions, OpenAPI descriptions are instantiated to a reference ontology. However, the mapping of composed or polymorphed Schema objects to the ontology generated additional problems to the mapping process. The mapping of composite Schema objects to the ontology is the focus of this work.

This is a preview of subscription content, log in via an institution to check access.

Access this chapter

Chapter
USD 29.95
Price excludes VAT (USA)
  • Available as PDF
  • Read on any device
  • Instant download
  • Own it forever
eBook
USD 219.00
Price excludes VAT (USA)
  • Available as EPUB and PDF
  • Read on any device
  • Instant download
  • Own it forever
Softcover Book
USD 279.99
Price excludes VAT (USA)
  • Compact, lightweight edition
  • Dispatched in 3 to 5 business days
  • Free shipping worldwide - see info

Tax calculation will be finalised at checkout

Purchases are for personal use only

Institutional subscriptions

Notes

  1. 1.

    http://www.intelligence.tuc.gr/semantic-open-api/.

  2. 2.

    https://petstore3.swagger.io.

References

  1. Bouraimis, F.: Instantiating OpenAPI Descriptions to the REST Services Ontology. Technical Report, Diploma Thesis, School of Electrical and Computer Engineering, Technical University of Crete (TUC), Chania, Crete (2021). https://dias.library.tuc.gr/view/88862

  2. Knublauch, H., Kontokostas, D.: Shapes Constraint Language (SHACL) (2017). https://www.w3.org/TR/shacl/

  3. Lanthaler, M., Gütl, C.: A Vocabulary for Hypermedia-Driven Web APIs. In: Workshop on Linked Data on the Web (LDOW 2013). Rio de Janeiro, Brazil (2013). http://www.markus-lanthaler.com/hydra/

  4. Musyaffa, F.A., Halilaj, L., Siebes, R., Orlandi, F., Auer, S.: Minimally invasive semantification of light weight service descriptions. In: IEEE International Conference on Web Services (ICWS 2016), pp. 672–677. San Francisco (2016). https://doi.org/10.1109/ICWS.2016.93, https://ieeexplore.ieee.org/document/7558066

  5. OpenAPI Specification v3.1.0 (2021). https://spec.openapis.org/oas/v3.1.0

  6. OWL-S: Semantic Markup for Web Services (2004). https://www.w3.org/Submission/OWL-S/. W3C Member Submission

  7. RAML Version 1.0: RESTful API Modeling Language (2021). https://raml.org

  8. Schwichtenberg, S., Gerth, C., Engels, G.: From Open API to Semantic Specifications and Code Adapters. In: IEEE International Conference on Web Services (ICWS 2017), pp. 484–491. San Francisco (2017). https://doi.org/10.1109/ICWS.2017.56, https://ieeexplore.ieee.org/document/8029798

  9. Web Application Description Language (2009). https://www.w3.org/Submission/wadl/. W3C Member Submission

  10. Web Services Description Language (WSDL) 1.1 (2001). https://www.w3.org/TR/wsdl.html

Download references

Author information

Authors and Affiliations

Authors

Corresponding author

Correspondence to Euripides G. M. Petrakis .

Editor information

Editors and Affiliations

Rights and permissions

Reprints and permissions

Copyright information

© 2022 The Author(s), under exclusive license to Springer Nature Switzerland AG

About this paper

Check for updates. Verify currency and authenticity via CrossMark

Cite this paper

Bouraimis, F., Mainas, N., Petrakis, E.G.M. (2022). Composition and Polymorphism Support in the OpenAPI Ontology. In: Barolli, L., Hussain, F., Enokido, T. (eds) Advanced Information Networking and Applications. AINA 2022. Lecture Notes in Networks and Systems, vol 449. Springer, Cham. https://doi.org/10.1007/978-3-030-99584-3_27

Download citation

Publish with us

Policies and ethics