Would it be possible to get ppt beforehand?
I was going to use the project http://enunciate.codehaus.org to automatically produce an API documentation, but alas, with the usage of the method parameter, it just fails. I've sent an email to their mailing list asking for suggestions. It was suggested to me to solve the delete and put operations programmatically - I can generate a filter that will take the method=put and method=delete and translate those to PUT and DELETE calls before they hit my actual code. The problem now remains with the method=publish operation (and mind you, in some cases we have more operations we expose).
Again, this fails when it comes to generating documentation to the API automatically.
Any suggestions on how to approach such an issue would be greatly appreciated.
i would model this as a change of state and use a PUT (method=PUT) on
the resource.
/entities/5678?method=PUT
state=published
i think that's your option #2.
on a different topic, you shouldn't need to specify more than 1 id in an URl.
for example
/sandboxes/1234/entities
is ok, but
/sandboxes/1234/entities/5678
is probably redundant. just indicating
/entities/5678
should get you to the desired element.
this might also make it cleaner to change the association from sandbox
to the totally different db.