Get files list - Get files list v1

Note: The latest specification for Collaborate 4.1.4 and above is here 

This is an API method to get a list of files from Collaborate. The file list can be filtered using a search query. 

Request

GET /files

Parameters:

Search Query Parameters:

 The search query consists of three parts

• Field  : Field specifying the search criteria. e.g site
• Operator : Test or condition that has to be performed on the data to create a filter
• Value : The content of the attribute that is to be tested, e.g folderid = 217

The representation of q parameter works as under

q = "folderid=1"

Where q parameter is in double quotes and is URL encoded.

With the current implementation of the files list API the q parameter only supports folderid, this parameter will be extended in the future implementations of the file list API to support a more detailed search criteria. 

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

</files>

<filetotal>Total no of files satisfying this search criteria</filetotal>

<file>

    <name>RRRRRRRRRR</name>

    <id>868</id>

    <versionid>1</versionid>

    <createddate>20 Jun 2014 10:06</createddate>

    <modifieddate>20 Jun 2014 10:06</modifieddate>

    <type>pdf</type>

 

   <folderid>123</folderid>

   <siteid>234</siteid>

   <icon>http://clientinstance.highq.com/clientinstance/images/fileicon/pdf.png</icon>

    <commentscount>0</commentscount>

    <likescount>0</likescount>

    <createdby>

        <firstname>Tom</firstname>

        <lastname>Chick</lastname>

        <email>user@highq.com</email>

        <userid>103</userid>

    </createdby>

    <modifiedby>

        <firstname>Tom</firstname>

        <lastname>Chick</lastname>

        <email>user@highq.com</email>

        <userid>103</userid>

    </modifiedby>

</file>

</files>

 Note:

• All dates are in UTC.
• In this phase we are only supporting folderid in q parameter  
  • eg: q="folderid=12"
• The default value for limit is 100
  • if limit>0 then (number of return data = limit)
  • if limit=-1 then return all data
  • if limit<-1 then default value of the limit will be returned, which is 100
• The default value of offset is 0 
  • if offset>0 the starting point will be the offset value. 
  • if offset<0 then the default value of 0 will be used by the system
• The default value of orderby parameter is descending (desc) 
• The default value for ordertype parameter is creation date