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