This is my goto resource when the team starts bike-shedding on implementation details. http://jsonapi.org/