Task:Download client for extras-applications/REST-API
The REST-API to fetch the content is based on the content part of the open collaboration services API. Right now the following calls are implemented:
CATEGORIES
The categories API is fully implemented. An example for the OS2008:
.../categories?parent=OS2008 :
<?xml version="1.0"?>
<ocs>
<meta>
<status>ok</status>
<message></message>
<totalitems>16</totalitems>
</meta>
<data>
<category>
<id>id</id>
<name>Multimedia</name>
</category>
<category>
<id>id</id>
<name>Games</name>
</category>
...
<category>
<id>id</id>
<name>Travel</name>
</category>
</data>
</ocs>
LIST
The idea of this call is to get a list regarding to the arguments, given in the specification. The following arguments are implemented:
- search: searches for a specified keyword
- categories: filters the list by the specified category
- page: content page
- pagesize: items per page
Further the list of fields, which are returned by the request are the ones you find in the example:
<?xml version="1.0"?>
<ocs>
<meta>
<status>ok</status>
<message></message>
<totalitems>1</totalitems>
</meta>
<data>
<content>
<id>id</id>
<name>name</name>
<version>1.0</version>
<changed>2009-05-06T12:05:13+0000</changed>
<created>2009-05-06T12:05:13+0000</created>
<downloads>0</downloads>
<score>0</score>
<comments>0</comments>
</content>
</data>
</ocs>
GET
The get-method is not based on the specification yet. Work is ongoing.
NEXT STEPS
- Adding details to the list component, like screen-shot and contributors (bergie)
- Adding sorting features to the list (date, karma, rating, alphabetical)
- Remove ratings from comments
Open issues
Related to the SSO task is the question on how to implement the features, where a log-in is required, like personal rating and commenting. One suggestion would be to use the salmon protocol for that. But this is still work in progress.