Search the web
Sign In
New User? Sign Up
rest-discuss · REST Discussion Mailing List
? Already a member? Sign in to Yahoo!

Yahoo! Groups Tips

Did you know...
Want your group to be featured on the Yahoo! Groups website? Add a group photo to Flickr.

Best of Y! Groups

   Check them out and nominate your group.
Having problems with message search? Fill out this form to ensure your group is one of the first to be migrated to the new message search system.

Messages

  Messages Help
Advanced
Recommendation on URIs for Web Service   Message List  
Reply | Forward Message #4858 of 14353 |

Hi Folks,

I have been going through the REST mailing during the last couple of
days to get some pointers on deigning URI for a work manager style
application. I have identified the following resources

workItems - collection of all workItems
workLists - collection of work item lists for role or participant
roles - list of all roles in a domain
participants - list of all participants in a domain.

I am in the process of identifying appropriate URIs for the systems
and have come up with the following.

create a work item: post /workItems
get a work item: get /workItems/<workItemId>
edit a work item: post /workItems/<workItemId>
accept work item: put /workItems/workItemId>/state
abort work item: put /workItems/<workItemId>/state
complete work item: put /workItems/<workItemId>/state
restart work item: put /workItems/<workItemId>/state
reassign work item: put /workItems/<workItemId>/state
save work item: put /workItems/<workItemId>/data
get work item history: get /workItems/<workItemId>/history
get my work list: get /workLists/myWorkList
get work list for participant: get /workLists/<participantName>
get work list for role: get /workLists/<roleName>

Can anyone provide feedback on the URIs since this is my first
iteration and I have struggled whether to use POST or PUT for
subsequent modifications to a resource. From my understanding I should
be using POST for partial representations and PUT for complete
representation. In the case of 'edit work item' i use a post because I
will not be passing back the complete representation of the resource.
Is this correct or am I whistling in the wind?


cheers
</jima>






Sun Feb 20, 2005 11:51 pm

jalateras
Offline Offline
Send Email Send Email

Forward
Message #4858 of 14353 |
Expand Messages Author Sort by Date

Hi Folks, I have been going through the REST mailing during the last couple of days to get some pointers on deigning URI for a work manager style application....
jalateras
Offline Send Email
Feb 20, 2005
11:51 pm

... jalateras> Can anyone provide feedback on the URIs since this is jalateras> my first iteration and I have struggled whether to use jalateras> POST or PUT...
Berend de Boer
berenddeboer
Offline Send Email
Feb 21, 2005
1:49 am

... That isn't really correct. The first thing you should do, though, is ask yourself *why* aren't you passing back the complete represenation of a resource. ...
Joe Gregorio
JCGregorio
Offline Send Email
Feb 21, 2005
2:19 am

... can you please elaborate. ... I was thinking of only passing the modified attributes of the resource back although I see what you mean. If I am to pass the...
Jim Alateras
jalateras
Offline Send Email
Feb 21, 2005
3:01 am

On Mon, 21 Feb 2005 14:01:01 +1100 (EST), Jim Alateras ... POST has a number of meanings, including creating a subordinate resource, or just a generic "process...
Joe Gregorio
JCGregorio
Offline Send Email
Feb 21, 2005
3:13 am

... thanks Joe, I meant to say PUT. Any comments about some of the other URIs in particular what do you think of the URIs related to changing the state of the...
Jim Alateras
jalateras
Offline Send Email
Feb 21, 2005
3:21 am

... PUT is for setting the current state of a resource - regardless of whether that resource 'existed' previously or not. This covers 'create' and 'update' ...
S. Mike Dierken
mdierken
Offline Send Email
Feb 21, 2005
4:19 am

... In general these URIs look good, given the short description you have given of the domain. There are some things which aren't clear which may impact the...
Joe Gregorio
JCGregorio
Offline Send Email
Feb 21, 2005
5:23 am

... Save would save the data associated with the work item without changing the state of the work item. It will be used when the participant does not have all...
Jim Alateras
jalateras
Offline Send Email
Feb 21, 2005
5:30 am

The service does manange the state of work items. Could you please elaborate on your point? ... Find local movie times and trailers on Yahoo! Movies. ...
Jim Alateras
jalateras
Offline Send Email
Feb 21, 2005
7:49 pm
Advanced

Copyright © 2009 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Guidelines - Help