Design and Build Great Web APIs

The Advantages of Sketching

Sketching APIs offers a handful of advantages. As I mention in the previous section, sketching is a great way to try things out and quickly get feedback from others on your ideas. When it takes so little time to try something out, you can afford to try several ideas before you settle on your preferred implementation approach. Sketching APIs can even help you be more creative when it comes to translating the design documents into working API examples.

Also, because the sketches are just small samples of responses (or even requests, if you are designing those too), you don’t need to do lots of work ahead of time. Sketches are simple, stand-alone snippets that convey your ideas without the need to write actual code and ...