Wrote a new blog post
https://www.prostdev.com/post/understanding-apis-part-1-what-is-an-api