Design and Build Great Web APIs

Chapter 6Sketching APIs

In Part II, we covered the work of turning API requirements into a solid design plan using a repeatable API design process. At the end of our design journey, we had a set of documents (sometimes called artifacts) that included our human-readable workflow document, a sequence diagram, and our machine-readable ALPS document.

Now it’s time to turn those artifacts into a working API by converting our design into an implementation. That’s what we’ll do over the next three chapters. Along the way, you’ll learn how to create quick API sketches, how to make a prototype of your API, and how to convert your sketches and prototypes into running NodeJS code. At each step of the journey, we’ll refine our implementation plans through ...