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
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.