List User Files

LIST [user] files

Endpoint URL http://api.webs.com/v1/filemanager/[user]
http://api.webs.com/v1/filemanager/[user]/[path]
HTTP Method GET
Parameters apikey=[partner key] (String)
token=[session token] (String)
password=[password] (String) required if token not provided
filter=[image | media | video | other] (String) optional
detailed = [detailed] (Boolean 1 or 0) optional, defaults to 0

Usage Notes

Specify a path to restrict the list to a particular folder. For example, to list the files in the hawaii subfolder of user Bill’s vacations folder, the endpoint URL would be:

http://api.freewebs.com/v1/filemanager/bill/vacations/hawaii

Omit the path to list all files in the top-level folder.

Specify an optional filter string to narrow the list to a particular type of file.

Specify whether or not to show detailed File Information in the list. If default=1 is passed, the metadata for the files will be shown in addition to the name and file ID. (for example of the metadata returned, see: http://developers.webs.com/docs/FileManager_Services/Get_File_Info)

Example Good Response

<rsp stat="ok">
  <user name="bill">
    <token>e286a13704e8b393112965235ff</token>
    <directory path="">vacations</directory>
    <directory path="">FWThumbnails</directory>
    <file fname="view.jpg" url="http://server/bill/view.jpg" size="47.4 Kb" path="" />
    <file fname="dogs.jpg" url="http://server/bill/dogs.jpg" size="67.8 Kb" path="" />
  </user>
</rsp>

Error Codes (see response format in Technical Description)

Code Response
300 Received unknown filter type: [filter type]
320 Cannot find or create session for user with information provided
340 Does not support this HTTP method for this operation
350 Encountered errors retrieving file list
351 Cannot find file path [file path]
360 Username [name] does not exist
370 Encountered errors during user existence check