On Thu, Mar 10, 2011 at 4:14 PM, Guillaume Lerouge <[email protected]> wrote: > Side topic: I'll get some feedback tomorrow from an XWiki users and how > they're using the REST API to expose XWiki data in a portal. > > Here's some of the feedback I got: > > - When retrieving the content of a page from REST, we get source content > (wiki syntax) -> il would be nice to be able to get HTML-rendered content > too > Indeed. This is just a matter of extending the API to "accept" other content type. Currently only XML and JSON are supported.
So for example if you do a $ curl http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/Main/pages/WebHome you will get an XML representation of Main.WebHome doing a $ curl -H "Accept: application/json" http://localhost:8080/xwiki/rest/wikis/xwiki/spaces/Main/pages/WebHome will give you a JSON representation. In the future we might think of having $ curl -H "Accept: text/html" ... -> Page rendered in HTML $ curl -H "Accept: application/pdf" ... -> Page rendered in PDF etc. This is not that hard to implement, though I remember that there was a bug in RestLet concerning "accept" variants that I hope it has been fixed. > - We'd need to provide some high-level services from REST -> for instance > a REST resource that sends back the whole arborescence of the wiki (right > now you have to retrieve every space, then every page of every space one by > one) > Well, navigating and discovering resources is one of the fundamental principle behind a REST API :) Anyway I understand the need. Again, this can be done quite easily and the result can be a document with links to all (or a subset of) the resources exposed through the REST API. This can be quite heavy from a computational point of view, above all if you are dealing with huge wikis (a lot of pages and spaces). Nothing that couldn't be solved by imposing some limits and a smart pagination mechanism. -Fabio > Guillaume > > On Thu, Mar 10, 2011 at 16:10, Fabio Mancinelli > <[email protected]>wrote: > >> Hi everybody, >> >> I was wondering in which XWiki subsystems the REST API is used in a direct >> way. >> I know that it is used in different place but I don't have a clear vision. >> >> Could you please tell me where are you using it? >> >> 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 > _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
