1. State of the Practice in Application Programming Interfaces (APIs): A Case Study
- Author
-
Timo Lehtonen, Ari Salonen, Marko Komssi, Elina Kettunen, Tommi Mikkonen, Mikko Raatikainen, Biffl, S, Navarro, E, Lowe, W, Sirjani, M, Mirandola, R, Weyns, D, Empirical Software Engineering research group, and Department of Computer Science
- Subjects
PAINS ,Process management ,Software engineering ,Application programming interface ,business.industry ,Computer science ,05 social sciences ,Case study ,050301 education ,020207 software engineering ,Cloud computing ,Usability ,02 engineering and technology ,113 Computer and information sciences ,Software ,Documentation ,API ,0202 electrical engineering, electronic engineering, information engineering ,Product management ,Technical management ,Software system ,API management ,business ,0503 education - Abstract
Application Programming Interfaces (APIs) have become prevalent in today’s software systems and services. APIs are basically a technical means to realize the co-operation between software systems or services. While there are several guidelines for API development, the actually applied practices and challenges are less clear. To better understand the state of the practice of API development and management in the industry, we conducted a descriptive case study in four Finnish software companies: two consultancy companies developing software for their customers, and two companies developing their software products. As a result, we identified five different usage scenarios for APIs and emphasize that diversity of usage should be taken into account more explicitly especially in research. API development and technical management are well supported by the existing tools and technologies especially available from the cloud technology. This leaves as the main challenge the selection of the right technology from the existing technology stack. Documentation and usability are practical issues to be considered and often less rigorously addressed. However, understanding what kind of API management model to apply for the business context appears as the major challenge. We also suggest considering APIs more clearly a separate concern in the product management with specific practices, such as API roadmapping.
- Published
- 2021