15 Dec
2008
15 Dec
'08
5:55 p.m.
Hi, Fabio.
1) Why we need /spaces/ and /pages/ ?
Can't we use just /{space}/{page}/... ?
What does mean /spaces/{space} GET: retrieves a space? What is space?
2) How could I get all translations of a page?
(so i think {page}/translatios is needed)
3) I think we need {page}/versions instead of {page}/history
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?
Thanks.
-Fabio
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs