Wrote a new blog post
https://www.prostdev.com/post/understanding-apis-part-2-api-analogies-and-examples