Fabrizio Lazzaretti

Generating API Specs from DDD Workshop Artifacts with Claude Opus 4.7

A walkthrough of generating API specifications from DDD workshop artifacts (API Product Canvas and Visual Glossary) using Claude Opus 4.7. The same recipe works for both OpenAPI and AsyncAPI. Demonstrated on the Catalog Search example from "Crafting Great APIs with Domain-Driven Design", showing how the model now surfaces the assumptions it bakes into the draft.

Talk: Crafting Great APIs with Domain-Driven Design at Spring I/O 2026

A recap of my session "Crafting Great APIs with Domain-Driven Design" at Spring I/O 2026 in Barcelona. From Business Process Canvas and Event Storming to the API Product Canvas, a collaborative approach that covers both sync and async communication, and how LLMs can accelerate the last mile to OpenAPI and AsyncAPI specs.

Book: Crafting Great APIs with Domain-Driven Design

A comprehensive guide to crafting asynchronous and synchronous APIs using Domain-Driven Design. Learn collaborative API design between IT and business experts, covering OpenAPI, AsyncAPI, and api design in greenfield as well as modernization strategies for legacy systems.

Talk: How to design OpenAPIs in Workshops: The API Product Canvas

OpenAPI is a great specification language for RESTful APIs, being machine-readable and well-suited for both developers and business analysts. However, when designing APIs in collaboration with IT and business, the YAML or JSON-based standard can be overwhelming for non-technical people. To better communicate API specifications, we developed the API Product Canvas, a tool that helps communicate API specifications with ease. We will present our learnings from designing APIs with IT and non-IT people and how to get to a result in a collaborative way to make well-architectured, business-oriented APIs that are understood by developers and work in production. The audience will be equipped with a new tool: the API Product Canvas, for communicating APIs.