The Alan Barr Show

API Design

Listen Later

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.
    • ...more
    View all episodesView all episodes
    Download on the App Store
    The Alan Barr ShowBy Alan Barr