Hacker News new | past | comments | ask | show | jobs | submit login

/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.




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.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: