Crafting Great APIs with Domain-Driven Design: Collaborative Craftsmanship of Asynchronous and Synchronous APIs

by Annegret Junker, Fabrizio Lazzaretti

Overview

Crafting, testing, and maintaining events and synchronous APIs represent one of the most challenging tasks in modern software applications. This comprehensive guide delves deeply into the intricacies of managing asynchronous and synchronous APIs using a consistent design approach.

The uniqueness of this book lies in its emphasis on collaborative API design between IT and business experts, facilitated by Domain-Driven Design (DDD). It provides clear guidance on selecting the appropriate communication strategy for different scenarios, ensuring that APIs meet the evolving needs of both developers and end-users.

Readers will gain valuable insights into using popular definition languages such as OpenAPI and AsyncAPI. This book offers a case study that demonstrates how the described methodologies can be applied to modernize legacy systems, ensuring compatibility with development practices.

By the end of this book readers, will be equipped to design APIs that are not only technically sound but also intuitive, reliable, and adaptable to the dynamic needs of modern applications.

You Will:

• Learn how to choose the most appropriate communication strategy for different scenarios, considering factors such as scalability, reliability, and compatibility with modern development practices.
• Explore the practical application of popular definition languages like OpenAPI and AsyncAPI to create robust APIs
• Learn how to facilitate collaborative API design between IT and business experts using Domain-Driven Design (DDD), ensuring that APIs align with both technical requirements and business objectives.

This book is for: Software architects, business analysts, developers and IT professionals

Product Details

ISBN-13:	9798868814563
Publisher:	Apress
Publication date:	08/27/2025
Edition description:	First Edition
Pages:	400
Product dimensions:	6.10(w) x 9.25(h) x (d)

About the Author

Annegret Junker is Chief Software Architect at codecentric AG in Germany. She has worked in software development for over 30 years. She worked in quite different roles and domains, e.g., insurance, car manufacturer, logistics, financial services, etc. She is interested in DDD, microservices, and everything along with it. Currently, she is helping a customer on a transition project in health insurance.

Fabrizio Lazzaretti is a Managing Consultant specializing in software architecture at Wavestone. He has over a decade of expertise in software architecture, development, and DevOps. He is a maintainer of the Cloud Native Computing Foundation (CNCF) project CloudEvents. Recognized for his proficiency as both a team player and leader in software development, architecture, and Scrum, he excels in dynamic work settings. His primary areas of expertise lie in event-driven architecture and microservice design within cloud environments. Currently, he is actively engaged in enterprise architecture within the insurance sector.

Table of Contents

Introduction.- Part I: The Importance of API Design.- Chapter 1: Transforming Problematic APIs.- Chapter 2: Communication Categories.- Chapter 3: Quality Requirements for APIs.- Part II: Domain Driven API Design.- Chapter 4: Online Library.- Chapter 5: API Design supported by Domain-driven Design.- Chapter 6: Definition of the Interfaces.- Chapter 7: Defining the Interfaces of the Online Library.- Part III: Enabling Tranformation.- Chapter 8: Developer experience and API implementation.- Chapter 9: Collaborative Design and Agility.- Chapter 10: Iterative Extesions.- Chapter 11: Brownfield Project.- Chapter 12: Shortcuts in the Process.- Chapter 13: APIs and Events in a Neverless World.- Part IV: Summarizing.- Chapter 14: Avoiding Mistakes in the Definition of Events and APIs.- Chapter 15: A Couple of Beautiful APIs.- Chapter 16: Summary.- Glossary.- Solutions.