@joeyAghion => Pragmatic RESTful API Design in the Artsy Public HAL+JSON API

I wrote a post introducing the new API and some design decisions behind its public face. I didn't go into details about testing or implementation, those could be probably separate and good topics.

Would appreciate feedback from @joeyAghion and everyone else, especially if you saw something in APIv2 that you think is worth talking about.
I changed it to this to be clearer:

"Accept headers in the API context can be used to indicate that the request is specifically limited to an API version. Our API will serve a backward compatible format by default. However, when we decide change the format of a resource we will increment the API version and require a newer value in the header to retrieve it. The new version can become the default only after the old version has been fully deprecated."