Using Web Sequence Diagrams with your APIs

Using Web Sequence Diagrams with your APIs

WSD: from design to docs

I’ve been working on a set of CLI tools to make designing, building, and documention APIs easier to do and a bit more repeatable/reliable over time. One of the tools I’ve been using lately is the Web Sequence Diagram (WSD) web app. I’ll show what WSD looks like, review the thinking behind it, and how it helps me design, document, and eventually build my APIs.

Lead API Architect, API Academy, CA Technologies

An internationally known author and lecturer, Mike Amundsen travels throughout the world consulting and speaking on a wide range of topics including distributed network architecture, Web application development, and other subjects.

In his role of Director of Architecture for the API Academy, Amundsen heads up the API Architecture and Design Practice in North America. He is responsible for working with companies to provide insight on how best to capitalize on the myriad opportunities APIs present to both consumers and the enterprise.

Amundsen has authored numerous books and papers on programming over the last 15 years. His collaboration with Leonard Richardson titled "RESTful Web APIs" was published in 2013. His 2011 book, “Building Hypermedia APIs with HTML5 and Node”, is an oft-cited reference on building adaptable Web applications. O’Reilly Media released his latest book - "RESTful Web Clients" in March of 2017.