Article in Proceedings INPROC-2017-08

BibliographyHaupt, Florian; Leymann, Frank; Scherer, Anton; Vukojevic-Haupt, Karolina: A Framework for the Structural Analysis of REST APIs.
In: Proceedings of the IEEE International Conference on Software Architecture (ICSA 2017).
University of Stuttgart, Faculty of Computer Science, Electrical Engineering, and Information Technology.
german.
IEEE, April 2017.
DOI: 10.1109/ICSA.2017.40.
Article in Proceedings (Conference Paper).
CR-SchemaD.2.11 (Software Engineering Software Architectures)
KeywordsREST; interface description language; analysis
Abstract

Today, REST APIs have established as a means for realizing distributed systems and are supposed to gain even more importance in the context of Cloud Computing, Internet of Things, and Microservices. Nevertheless, many existing REST APIs are known to be not well-designed, resulting in the absence of desirable quality attributes that truly RESTful systems entail. Although existing analysis show, that many REST APIs are not fully REST compliant, it is still an open issue how to improve this deficit and where to start. In this work, we introduce a framework for the structural analysis of REST APIs based on their description documents, as this allows for a comprehensive, well-structured analysis approach that also includes analyzing the corresponding API description languages. A first validation builds on a set of 286 real world API descriptions available as Swagger documents, and comprises their transformation into a canonical metamodel for REST APIs as well as a metrics-based analysis and discussion of their structural characteristics with respect to compliance with the REST architectural style.

Contactflorian.haupt@iaas.uni-stuttgart.de
Department(s)University of Stuttgart, Institute of Architecture of Application Systems
Entry dateMarch 1, 2017
   Publ. Institute   Publ. Computer Science