Chapter 7Prototyping APIs

In the previous chapter, we discussed the idea of creating simple sketches of your API design. We saw from renowned architect Frank Gehry’s habit that creating quick sketches lets us test out our ideas and see how they might look before committing a great deal of resources and effort to actually building them out completely. Like Gehry, we can create simple examples of our planned APIs to get an idea of how they will “look” once they’re implemented. Sketches are simple explorations that can lead us to discover the design details that are most likely to solve our API problem.

One step past sketching is what I call prototyping. Prototypes are more than simple drawings or snippets of JSON or HTML. Prototypes have ...

Get Design and Build Great Web APIs 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.