Skip to Main content Skip to Navigation
Conference papers

Extending OpenAPI 3.0 to Build Web Services from their Specification

Abstract : Web services are meant to be used by other programs. Developers (or other programs) need to understand how to interact with them, which means documentation is crucial. Some standards like OpenAPI define ways to document web services and target both humans and programs. Many tools can be used to help developers to work in a forward engineering process: they use hand-written OpenAPI models as input and automatically generate a skeleton of a working application, for example. However, this approach is not suitable to generate working applications if several evolutions occur over time, which often results in a misalignment between the OpenAPI model and the web services implementation. Here we show how we extend the OpenAPI 3.0 specification to allow building actual web services using a Model-Driven Engineering (MDE) approach. We extend the SWSG tool to make it possible to generate code from an extended OpenAPI model. This leverages a MDE approach to build web services from a model while benefiting from OpenAPI 3.0 tooling and ecosystem.
Complete list of metadatas

Cited literature [18 references]  Display  Hide  Download

https://hal.archives-ouvertes.fr/hal-01868498
Contributor : David Sferruzza <>
Submitted on : Wednesday, September 5, 2018 - 3:01:40 PM
Last modification on : Thursday, February 27, 2020 - 1:05:52 AM
Document(s) archivé(s) le : Thursday, December 6, 2018 - 5:04:13 PM

File

extending-openapi.pdf
Files produced by the author(s)

Licence


Distributed under a Creative Commons Attribution 4.0 International License

Identifiers

  • HAL Id : hal-01868498, version 1

Citation

David Sferruzza, Jérôme Rocheteau, Christian Attiogbé, Arnaud Lanoix. Extending OpenAPI 3.0 to Build Web Services from their Specification. International Conference on Web Information Systems and Technologies, INSTICC, Sep 2018, Seville, Spain. ⟨hal-01868498⟩

Share

Metrics

Record views

300

Files downloads

773