@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.
Yeah I'd consolidate this. I'm convinced!

I think it's not a given that the old style is worse for overall performance, and needs some justification if you actually intend to make that argument. The new, flat response style _could_ be combined with aggressive HTTP caching and HAL-aware client libraries to eke out extra performance, but initially requires many more requests.