Comments on: Versioned Resources In REST APIs http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/ Living in a state of accord. Wed, 03 Dec 2008 01:26:21 +0000 http://wordpress.org/?v=2.6.5 By: David Venz http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-102029 David Venz Tue, 31 Jul 2007 10:07:11 +0000 https://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-102029 Adrian, I would suggest that each version of the doc is a separate resource. It has a relationship to the previous versions (however you encode that, if at all), and may share a fair few attributes with it (such as a similar start of URL). Each version has what you might call a 'fully qualified' URL, and you can arrange for a 'short URL' to get the current one; much like the old Linux distro 'current' link idea. The list of versions is a separate resource again. Cheers, -Dave. Adrian,

I would suggest that each version of the doc is a separate resource. It has a relationship to the previous versions (however you encode that, if at all), and may share a fair few attributes with it (such as a similar start of URL). Each version has what you might call a ‘fully qualified’ URL, and you can arrange for a ’short URL’ to get the current one; much like the old Linux distro ‘current’ link idea. The list of versions is a separate resource again.

Cheers,
-Dave.

]]> By: Symphonious » APP For Scalability http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100505 Symphonious » APP For Scalability Fri, 27 Jul 2007 08:39:21 +0000 https://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100505 [...]   « Versioned Resources In REST APIs [...] [...]   « Versioned Resources In REST APIs [...]

]]> By: Adrian Sutton http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100418 Adrian Sutton Fri, 27 Jul 2007 04:04:38 +0000 https://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100418 DHH, That seems to match my thinking with .../resource.html/versions (though the brain dump above didn't wind up saying that). It's reasonable but still doesn't quite feel right because the versions are really part of the original resource and this makes it look quite different. It feels more semantically correct to use parameters to request specific aspects of a resource like a specific version or the list of versions. That leads to URLs that don't really look like REST but I think it matches the semantic ideas better and the normal case is still a nice clean URL. Probably personal taste really. Dave, WebDAV feels like overkill but is probably the right standards based option. DHH,
That seems to match my thinking with …/resource.html/versions (though the brain dump above didn’t wind up saying that). It’s reasonable but still doesn’t quite feel right because the versions are really part of the original resource and this makes it look quite different. It feels more semantically correct to use parameters to request specific aspects of a resource like a specific version or the list of versions. That leads to URLs that don’t really look like REST but I think it matches the semantic ideas better and the normal case is still a nice clean URL. Probably personal taste really.

Dave, WebDAV feels like overkill but is probably the right standards based option.

]]> By: DHH http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100416 DHH Fri, 27 Jul 2007 03:46:28 +0000 https://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100416 Treat each version as it's own resource. /document/1 (latest version), /document/1/versions (list of all versions), /document/1/versions/a (a specific version). Treat each version as it’s own resource. /document/1 (latest version), /document/1/versions (list of all versions), /document/1/versions/a (a specific version).

]]> By: Dave Brondsema http://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100410 Dave Brondsema Fri, 27 Jul 2007 03:00:27 +0000 https://www.symphonious.net/2007/07/27/versioned-resources-in-rest-apis/#comment-100410 WebDav versioning via rfc3253, perhaps? That's idle speculation.. I have no experience with such things to know if/when that would be a good idea and when not. WebDav versioning via rfc3253, perhaps? That’s idle speculation.. I have no experience with such things to know if/when that would be a good idea and when not.

]]>