Prof. Dr. Cesare Pautasso

A Large-scale Empirical Assessment of Web API Size Evolution

Fabio Di Lauro, Souhaila Serbout, Cesare Pautasso

Journal of Web Engineering, vol. 21, issue 6, pp.1937-1980

November 2022

Abstract

Like any other type of software, also Web Application Programming Interfaces (APIs) evolve over time. In the case of widely used API, introducing changes is never a trivial task, because of the risk of breaking thousands of clients relying on the API. In this paper we conduct an empirical study over a large collection of OpenAPI descriptions obtained by mining open source repositories. We measure the speed at which Web APIs change and how changes affect their size, simply defined as the number of operations. The dataset of API descriptions was collected over a period of one year and includes APIs with histories spanning across up to 7 years of commits. The main finding is that APIs tend to grow, although some do reduce their size, as shown in the case study examples included in the appendix.

Download

DOI: 10.13052/jwe1540-9589.2167

PDF: ▼apiace-jwe-2022.pdf (43MB)

Citation

Bibtex

@article{2022:jwe,
	author = {Fabio Di Lauro and Souhaila Serbout and Cesare Pautasso},
	title = {A Large-scale Empirical Assessment of Web API Size Evolution},
	journal = {Journal of Web Engineering},
	volume = {21},
	number = {6},
	year = {2022},
	month = {November},
	pages = {1937-1980},
	doi = {10.13052/jwe1540-9589.2167},
	abstract = {Like any other type of software, also Web Application Programming Interfaces (APIs) evolve over time. In the case of widely used API, introducing changes is never a trivial task, because of the risk of breaking thousands of clients relying on the API. In this paper we conduct an empirical study over a large collection of OpenAPI descriptions obtained by mining open source repositories. We measure the speed at which Web APIs change and how changes affect their size, simply defined as the number of operations. The dataset of API descriptions was collected over a period of one year and includes APIs with histories spanning across up to 7 years of commits. The main finding is that APIs tend to grow, although some do reduce their size, as shown in the case study examples included in the appendix.},
	keywords = {API Evolution}
}