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
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
