Comments on: HTTP method primer for RESTful web services http://watchitlater.com/blog/2009/11/http-method-primer-for-restful-web-services/ A reluctant foray into the world of blogging. Mon, 06 Sep 2010 11:01:13 +0000 http://wordpress.org/?v=2.9.2 hourly 1 By: Prodis a.k.a. Fernando Hamasaki de Amorim http://watchitlater.com/blog/2009/11/http-method-primer-for-restful-web-services/comment-page-1/#comment-5158 Prodis a.k.a. Fernando Hamasaki de Amorim Tue, 17 Nov 2009 11:26:53 +0000 http://watchitlater.com/blog/?p=72#comment-5158 Good summary. Good summary.

]]> By: Tom http://watchitlater.com/blog/2009/11/http-method-primer-for-restful-web-services/comment-page-1/#comment-5105 Tom Wed, 11 Nov 2009 08:10:13 +0000 http://watchitlater.com/blog/?p=72#comment-5105 Stephen, you are correct that the application should only have one representation of myweblog. That's why I'm assuming that I want to POST the representation of a weblog to a factory resource at /weblogs/myweblog (which is the single instance). The factory resource creates a new weblog and assigns it the id SS0093WSA. The response is then a 201 with a "Location" header /weblogs/myweblog/entries/SS0093WSA, which is the URI to view the newly created weblog entry. I could POST to /weblogs/myweblog/entries to create a new weblog which would be equally as valid and probably has less *magic* in it since it is a bit more clear that posting to /weblogs/myweblog/entries creates a new weblog entry. However in terms of subordinate resources as long as the generated resource is addressed somewhere under /weblogs/myweblog I can use the service at /weblogs/myweblog as a resource factory, its just less clear that it is a resource factory. Conceptually if you perform a HTTP GET on /weblogs/myweblog you could get a representation of all weblog entries, or a redirect to /weblogs/myweblog/entries to get a list of all entries, or simply a 405 (Method Not Allowed) with an "Allow" header stating that you can only PUT requests are permitted. Stephen, you are correct that the application should only have one representation of myweblog. That’s why I’m assuming that I want to POST the representation of a weblog to a factory resource at /weblogs/myweblog (which is the single instance). The factory resource creates a new weblog and assigns it the id SS0093WSA. The response is then a 201 with a “Location” header /weblogs/myweblog/entries/SS0093WSA, which is the URI to view the newly created weblog entry.

I could POST to /weblogs/myweblog/entries to create a new weblog which would be equally as valid and probably has less *magic* in it since it is a bit more clear that posting to /weblogs/myweblog/entries creates a new weblog entry. However in terms of subordinate resources as long as the generated resource is addressed somewhere under /weblogs/myweblog I can use the service at /weblogs/myweblog as a resource factory, its just less clear that it is a resource factory.

Conceptually if you perform a HTTP GET on /weblogs/myweblog you could get a representation of all weblog entries, or a redirect to /weblogs/myweblog/entries to get a list of all entries, or simply a 405 (Method Not Allowed) with an “Allow” header stating that you can only PUT requests are permitted.

]]> By: Stephen Chu http://watchitlater.com/blog/2009/11/http-method-primer-for-restful-web-services/comment-page-1/#comment-5102 Stephen Chu Tue, 10 Nov 2009 19:57:50 +0000 http://watchitlater.com/blog/?p=72#comment-5102 Good, succinct summary. One question: did you mean "POST /weblogs/myweblog/*entries*" to create a new entry for myweblog instead? Because to me, POST-ing to /weblogs/myweblog is to create the (singular) resource "myweblog". By singular, I mean the application can only have at max one instance of myweblog. (analogous to map.resource (singular) in Rails). Good, succinct summary. One question: did you mean “POST /weblogs/myweblog/*entries*” to create a new entry for myweblog instead? Because to me, POST-ing to /weblogs/myweblog is to create the (singular) resource “myweblog”. By singular, I mean the application can only have at max one instance of myweblog. (analogous to map.resource (singular) in Rails).

]]>