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 (livebook.manning.com/concept/api/api-goal-canvas) - Who - What - How - Inputs - Outputs - Goals

Alan's Digital Garden (notes.alanmbarr.com/Sources/Articles/2021%20Th…) 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.