On Mon, Jun 25, 2012 at 7:46 PM, Ludovic Dubost <ludovic(a)xwiki.com> wrote:
While working on a prototype on a HTML5 mobile and
desktop application
I've hit a few limitations of the REST APIs.
This is why I propose some enhancements to the current REST APIs to
give more flexibility, particularly:
Support for start and order parameter in queries returning large
list of pages
For complete and easy pagination it would be nice to support/get at
least the following for anything that return a list of anything:
* start
* offset
* optional totalHits
like Extension Repository REST API does. See
https://github.com/xwiki/xwiki-commons/blob/master/xwiki-commons-core/xwiki…
Support order parameter in page list
Adding page version, author information and data information when missing
+1
Hidden documents filter activation or deactivation
in REST APIs
+1
Adding pretty display of title and author names
Only if it's disabled by default and you can enable it with a
parameter. This is potentially pretty expensive and not everyone needs
it when dealing with pure datas through REST.
Support queries using XWQL, HQL and Lucene
Big +1.
This one is definitely a very important missing peace in REST API.
The rendered content should be accessible from REST
apis
Note that getting the rendered content of a document in any output
syntax can be done easily with /get/ action right now.
The details of the proposal is here:
http://dev.xwiki.org/xwiki/bin/view/Design/RESTApiImprovements
A pull request for a prototype implementation of these requirements is
available here:
https://github.com/xwiki/xwiki-platform/pull/56/files#r1040052
Not everything has an implementation (hidden docs and rendered content
is not implemented yet). Other are not implementing according to this
specification as some comments have already been made.
Particularly the following votes are required:
VOTE to accept supporting "start" and "order" parameters only on
queries having only one unique scope
VOTE in search queries for just adding the descendent date order or
add more order possibilities using order and orderdir param
VOTE in page list queries for just adding the descendent date order or
add more order possibilities using order and orderdir param
VOTE to add page version and author fields to page and other resources
VOTE for adding the additional fields with or without a parameter
"pagedetails=1"
VOTE for adding a parameter to show/hide hidden documents independent
of user setting
VOTE to add the displayTitle field with or without the pagedetails=1
parameter or with it's own parameter displayTitle=1
VOTE to add the author display names with or without the
displayPrettyNames parameter
VOTE for supporting the searchQuery API at the wiki level with multi
wiki support at the lucene level
VOTE for adding rendered content using the withrenderedcontent=1 param
VOTE for having absolute URLs in the rendered content using
withabsoluteurls=1 param
There is a lot of things here and it''s hard to vote for everything at
once, would be better to at least separate them by domain (rendering,
search, page listing, etc.). Otherwise some that are almost obvious
are going to be blocked by more debatable ones.
Thanks
Ludovic
--
Ludovic Dubost
Founder and CEO
Blog:
http://blog.ludovic.org/
XWiki:
http://www.xwiki.com
Skype: ldubost GTalk: ldubost
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne