Translating Your API Design into HTTP
The critical element in all this work is to take our original API design into a valid HTTP design. We need to convert the list of properties and actions from our ALPS description in Chapter 5, âDescribing APIsâ, into a well-defined HTTP API specification. This is where the magic happensâthe art of translation. I use the word art because there is no science or engineering that can properly convert your design into a protocol-specific definition. We still need to rely on creative humans to do this work. Thatâs why sketching and prototyping can be so handy. It lets us work out decisions quickly and easily without a lot of expense.
Itâs also important to point out that weâve already decided that ...
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.
