Other question: Why use the plural when retrieving a single instance. For example: /spaces --> All spaces /space/{space} --> One space Ah just saw you changed that but not everywhere. Like classes/{class} should be class/{class} And pages/{page} should be page/{page} no? Re nested spaces the best is probably to define a delimiter other than "/" Something like: /space/this::is::nested/page/WebHome Of course this would mean that "::" is not allowed in space names. BTW this would also means that "/" is not allowed in space names. -Vincent On Dec 15, 2008, at 5:39 PM, Fabio Mancinelli wrote:
Vincent Massol wrote:
Note that I don't know what are the REST best practices. I'm jut noticing the inconsistency.
Ok. I saw what you meant. I modified a bit the resources to remove the inconsistency. I did this because attachments have also their own versioning. So you can access a specific version of an attachment either by requesting an attachment at a given page version or by requesting an specific version of an attachment.
To be consistent I only left the resources for referring to an attachment starting for a given page version:
/space/{space}/pages/{page}/attachments /space/{space}/pages/{page}/attachments/{attachment} /space/{space}/pages/{page}/{version}/attachments/ /space/{space}/pages/{page}/{version}/attachments/{attachment}
I still maintained the non-verbose version but that can be changed if there is not an agreement on it.
However it might be still useful to expose attachment resources by using their own versioning:
/space/{space}/pages/{page}/attachments/{attachment}/history /space/{space}/pages/{page}/attachments/{attachment}/{version}
Thanks.
-Fabio _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs