In this episode, I review a few books on API Design. The Design of Web APIs by Arnaud Lauret the API Handyman, Irresistible APIs by Kirsten Hunter, and API Design Patterns by JJ Geewax. I also brainfart may refer to Kirsten Hunter as Kirsten Stewart so just ignore that.

Act 1 - What is the goal of the API?

API Goal Canvas - Who - What - How - Inputs - Outputs - Goals

Alan's Digital Garden if the Manning link doesn't work in the future.

Act 2 - What makes a “good” API?

Act 3 - RESTful HTTP Guidance and Support

Summary

• Define the goals and metrics of the API via design discussions and the API Goal Canvas and get feedback.


• A good API is fit for purpose, consistent, and expressive.


• RESTful HTTP Guidance and Supporting your API is more than the implementation. Support, Examples, Tutorials, workflows. etc.