I’ve just put together some thoughts on APIs and how to manage different versions of them though headers instead of paths, all learnt through the development of Flying Sphinx.

It’s not the One True Way of API development, but I find it very elegant and welcome feedback.