API Design First and Mocks as Prototypes

Creator of WireMock: Building a Successful OSS and The Art of API Mocking - Tom Akehurst

Topic 6 of 11

Published Mar 24, 2025 · Clip 27:27–32:32 (5:05)

Tom advocates API design-first when producer-consumer collaboration is possible, since thoughtful upfront design beats generating design from code. Mocks can serve as prototypes of APIs, letting consumers validate designs by writing code against them rather than just inspecting documents. He shares a banking anecdote where exposing a single missing field took a three-month, five-team rework, illustrating the value of shifting design feedback left.