Dec 20 2021
API Design
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.