Chapter 6
API Modeling
You can use an eraser on the drafting table or a sledgehammer on the construction site.
— Frank Lloyd Wright
Developers are often tempted to start writing code immediately. Code is the primary tool for developers. It is everything—the hammer, screwdriver, ruler, and saw. When code is seen as the one and only tool to design an API, the quality of the API design can suffer. The march to produce code for production becomes more valued than the outcomes the API is meant to produce.
Of course, code produces value when it is used to explore a specific area of a solution to reduce risk. It is also valuable to use code to experiment, surface unknowns, or explore a new technology. The term tracer bullet was applied to software ...
Get Principles of Web API Design: Delivering Value with APIs and Microservices now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
