Design and Build Great Web APIs

The Design Phase

In the design phase, we explored the processes of capturing the essence of the problem you need to solve and translating that into a consistent design ready for developers to use. In Chapter 3, ​Modeling APIs​, you saw the power of Donald Norman’s Action Lifecycle and the importance of writing your API story and documenting the API workflow that captures the essence of the business problem. We covered the actual design process of identifying and detailing all the actions and properties of your API interface in Chapter 4, ​Designing APIs​, and learned how to document these API properties in a machine-readable, technology-agnostic way with the ALPS description format in Chapter 5, ​Describing APIs​.

Above all you learned that properly ...