Design and Build Great Web APIs

What Is an API Prototype?

A prototype is a multidimensional model. These models can be the source material or the guide for creating the final full-sized object you’re creating. The very word prototype derives from Greek and translates as “original,” “first,” or “impression.” All of these words speak to the notion of creating a prototype first to help you work out details at a small scale. And that’s important for APIs too.

Prototypes are valuable because they allow you to turn your sketches into something more substantial without taking on too much time and added expense. They also let you actually practice your design and see it in detail from multiple angles. In essence, prototypes take the “surprise” out of building your final product. ...