Microservice API Evolution in Practice: A Study on Strategies and Challenges

AI-generated keywords: Microservice API Evolution

AI-generated Key Points

  • Researchers conducted 17 semi-structured interviews with industry practitioners to identify microservice API evolution strategies and challenges.
  • Participants had an average of 10 years of practical experience and 4.5 years of experience with loosely coupled services.
  • Member checking was utilized, with feedback from participants resulting in minor remarks incorporated into the findings.
  • Participant selection was done through snowball sampling, leading to 20 interviews conducted with participants from 12 companies.
  • The study focused on message exchange techniques and documentation practices in microservices.
  • Six strategies and six challenges for REST and event-driven communication were identified in microservice API evolution.
  • Challenges included change impact analysis efforts, ineffective communication of changes, and consumer reliance on outdated versions leading to API design degradation.
  • Proposed solutions included automating change impact analysis and improving communication of changes as open research directions.
Also access our AI generated: Comprehensive summary, Lay summary, Blog-like article; or ask questions about this paper to our AI assistant.

Authors: Alexander Lercher, Johann Glock, Christian Macho, Martin Pinzger

License: CC BY 4.0

Abstract: Nowadays, many companies design and develop their software systems as a set of loosely coupled microservices that communicate via their Application Programming Interfaces (APIs). While the loose coupling improves maintainability, scalability, and fault tolerance, it poses new challenges to the API evolution process. Related works identified communication and integration as major API evolution challenges but did not provide the underlying reasons and research directions to mitigate them. In this paper, we aim to identify microservice API evolution strategies and challenges in practice and gain a broader perspective of their relationships. We conducted 17 semi-structured interviews with developers, architects, and managers in 11 companies and analyzed the interviews with open coding used in grounded theory. In total, we identified six strategies and six challenges for REpresentational State Transfer (REST) and event-driven communication via message brokers. The strategies mainly focus on API backward compatibility, versioning, and close collaboration between teams. The challenges include change impact analysis efforts, ineffective communication of changes, and consumer reliance on outdated versions, leading to API design degradation. We defined two important problems in microservice API evolution resulting from the challenges and their coping strategies: tight organizational coupling and consumer lock-in. To mitigate these two problems, we propose automating the change impact analysis and investigating effective communication of changes as open research directions.

Submitted to arXiv on 14 Nov. 2023

Ask questions about this paper to our AI assistant

You can also chat with multiple papers at once here.

AI assistant instructions?

Results of the summarizing process for the arXiv paper: 2311.08175v1

In this study, the researchers aimed to identify microservice API evolution strategies and challenges in practice by conducting 17 semi-structured interviews with developers, architects, and managers in 11 companies. The participants were industry practitioners with an average of 10 years of practical experience and an average of 4.5 years of experience with loosely coupled services. The study utilized member checking by sharing the results with participants for feedback and validation, resulting in minor remarks from two participants that were incorporated into the findings. Participant selection was done through snowball sampling, contacting previous colleagues and asking them to forward interview requests to peers matching the study's requirements. A total of 25 colleagues were contacted directly, leading to 20 interviews conducted with participants from 12 companies. Three interviews were excluded from the results due to various reasons such as handling API evolution like internal source code changes or not introducing breaking changes to product APIs yet. The study focused on message exchange techniques used in practice and their corresponding documentation techniques, answering the research question of how developers exchange messages between services and document them. Interviews lasted between 52-92 minutes, conducted both online via videoconference and in person without noticeable differences in participant openness or involvement based on the mode of communication. Overall, the research findings identified six strategies and six challenges for REST and event-driven communication via message brokers in microservice API evolution. Strategies emphasized API backward compatibility, versioning, and close collaboration between teams while challenges included change impact analysis efforts, ineffective communication of changes, and consumer reliance on outdated versions leading to API design degradation. The study highlighted important problems such as tight organizational coupling and consumer lock-in resulting from these challenges along with proposed solutions like automating change impact analysis and improving communication of changes as open research directions.
Created on 29 May. 2025

Assess the quality of the AI-generated content by voting

Score: 0

Why do we need votes?

Votes are used to determine whether we need to re-run our summarizing tools. If the count reaches -10, our tools can be restarted.

Similar papers summarized with our AI tools

Navigate through even more similar papers through a

tree representation

Look for similar papers (in beta version)

By clicking on the button above, our algorithm will scan all papers in our database to find the closest based on the contents of the full papers and not just on metadata. Please note that it only works for papers that we have generated summaries for and you can rerun it from time to time to get a more accurate result while our database grows.

Disclaimer: The AI-based summarization tool and virtual assistant provided on this website may not always provide accurate and complete summaries or responses. We encourage you to carefully review and evaluate the generated content to ensure its quality and relevance to your needs.