API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
What is the version negotiation to which this header alludes? Just the `Accept` field in a Request?