Describing Your API with ALPS
Recall from Chapter 4, âDesigning APIsâ, that we designed the onboarding experience and documented it using, among other things, a sequence diagram, as shown in the figure.
We can use this diagram, along with the data properties we outlined, as a guide to create an ALPS description document for our API (see Table 1).
The work of authoring an ALPS document is the process of converting the diagram (along with the property information) into a machine-readable format. This format can then be used to generate basic human-readable documentation, as well as some âstarterâ code for our implementation.
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.