Re:Simplicity Matters By Rich Hickey (Keynote at RailsConf 2...
by rapala on Thursday May 17, 2012 @03:47AM
(#3985921)
The structure of the representation under a version should stay constant or else you void your social contract with consumers of your service.
Yes, but the version should be stated in the Content-Type header, not in the URI of the resource. URI identifies the resource and Content-Type identifies the representation.
REST = Representational state transfer. While a URI is a unique identifier, it uniquely identifies a representation of internal state. The structure of the representation under a version should stay constant or else you void your social contract with consumers of your service.