15 Dec
2008
15 Dec
'08
5:06 p.m.
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}
Note that I don't know what are the REST best practices. I'm jut
noticing the inconsistency.
2) How will we support nested spaces?
Thanks
-Vincent
On Dec 15, 2008, at 4:43 PM, Fabio Mancinelli wrote:
Dear all,
I worked a bit on the design of the RESTful API and as a result I've
integrated what was written on the
http://dev.xwiki.org/xwiki/bin/view/Design/RestfulAPI page.
There is still a big and important part missing (maybe the most
important one), i.e., the one about the data formats for
representations
(in particular the XML schemas to be used in requests and
responses). I
am working on it.
Anyway you can already comment on what is present on the page.
Thank you.
-Fabio