Design and Build Great Web APIs

What’s Next?

In this chapter, we learned how to convert our initial workflow document into a rendered sequence diagram. That process included using the schema.org online vocabulary as a guide when resolving the data field names in our API to names commonly understood on the web. We also learned about the difference between resource state and transitions and the importance of identifying parameters when we create our API designs.

We covered the basics of the WebSequenceDiagrams online editor and we learned how to use it to generate sequence diagrams and save these diagrams as PNG images. The diagrams will be helpful during the design process and will also aid developers when they convert our design into a working API.

Finally, we used a handy ...