Extending OpenAPI 3.0 to Build Web Services from their Specification

David Sferruzza, Jérôme Rocheteau, Christian Attiogbé, Arnaud Lanoix

2018

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.

Paper Citation

in Harvard Style

Sferruzza D., Rocheteau J., Attiogbé C. and Lanoix A. (2018). Extending OpenAPI 3.0 to Build Web Services from their Specification.In Proceedings of the 14th International Conference on Web Information Systems and Technologies - Volume 1: APMDWE, ISBN 978-989-758-324-7, pages 412-419. DOI: 10.5220/0006923604120419

in Bibtex Style

@conference{apmdwe18,
author={David Sferruzza and Jérôme Rocheteau and Christian Attiogbé and Arnaud Lanoix},
title={Extending OpenAPI 3.0 to Build Web Services from their Specification},
booktitle={Proceedings of the 14th International Conference on Web Information Systems and Technologies - Volume 1: APMDWE,},
year={2018},
pages={412-419},
publisher={SciTePress},
organization={INSTICC},
doi={10.5220/0006923604120419},
isbn={978-989-758-324-7},
}

in EndNote Style

TY - CONF

JO - Proceedings of the 14th International Conference on Web Information Systems and Technologies - Volume 1: APMDWE,
TI - Extending OpenAPI 3.0 to Build Web Services from their Specification
SN - 978-989-758-324-7
AU - Sferruzza D.
AU - Rocheteau J.
AU - Attiogbé C.
AU - Lanoix A.
PY - 2018
SP - 412
EP - 419
DO - 10.5220/0006923604120419