Core principles of API Design - Part 2

This is the sequel to: API Design 1 I laid out the principles behind designing an API and wanted to show those principles in play in a non-trivial example. Turns out it's difficult to find the “goldilocks example” i.e. not too hard not too easy. So i...