On Dec 15, 2008, at 5:24 PM, Fabio Mancinelli wrote:
> Vincent Massol wrote:
>> Hi Fabio,
>>
>> Looks good. 2 questions:
>>
>> 1)
>>
>> # /spaces/{space}/pages/{page}/translations[?start=offset&number=n]
>> (The list of all available translations of the page {space}.{page})
>> # /spaces/{space}/pages/{page}/{version} (The page {space}.{page}. at
>> version {version})
>> # /spaces/{space}/pages/{page}/{lang} (The page {space}.{page} in its
>> {lang} translation)
>> # /spaces/{space}/pages/{page}/{lang}/history (The list of all the
>> available revision of the page {space}.{page} in it {lang}
>> translation.)
>> # /spaces/{space}/pages/{page}/{lang}/{version}
>>
>> This seems somewhat inconsistent with "pages", "attachments",
>> "objects"
>>
>> Why not have "versions" and "translations"? For example:
>> /spaces/{space}/pages/{page}/versions/{version}
>>
> I thought that having shorter URIs would be better. But I am not
> against
> having something like
>
> /spaces/{space}/pages/{page}
> /spaces/{space}/pages/{page}/versions
> /spaces/{space}/pages/{page}/versions/{version}
> /spaces/{space}/pages/{page}/translations
> /spaces/{space}/pages/{page}/translations/{language}
> /spaces/{space}/pages/{page}/translations/{language}/versions
> /spaces/{space}/pages/{page}/translations/{language}/versions/
> {version}
>
> Or similar.
>
>> Note that I don't know what are the REST best practices. I'm jut
>> noticing the inconsistency.
>>
> URI design is not that important (as long as the hypermedia
> constraints
> is fully leveraged). However having descriptive URIs and consistent
> URIs
> can enhance the possibility of discovering resources by guessing (i.e.
> the level of "serendipity")
>
>> 2) How will we support nested spaces?
>>
>
> Actually I didn't address the nested spaces issue.
> Spaces can be nested at an arbitrary level?
Not yet but we want to support this in the future yes so better design
a REST API that will work with nested spaces (arbitrary level yes).
Thanks
-Vincent
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
