3 ms·
/v1/people/john and /v2/people/john are different representations of the same internal state. REST = Representational state transfer. While a URI is a unique
by ericmoritz 14y ago
/v1/people/john and /v2/people/john are different representations of the same internal state.
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.
- rapala 14y agoThe 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.