Skip to main content
English (United States) Nederlands

Assets Server REST API - browse

Updated
GET/POST 
http://yourserver.com/services/browse
    ?path=<assetPath>
    &fromRoot=<folderPath>
    &includeFolders=<true|false>
    &includeAssets=<true|false>
    &includeExtensions=<comma-delimited extensions>

What does it do?

Browse folders.

This call is designed to make it possible to browse folders and show their subfolders and collections, similar to how folder browsing works in Assets.

Note: Even though it is possible to return the assets in folders, doing so is not advised. The browse call does not limit the number of results, so if there are 10000 assets in a folder it will return all of them. It is better to use a search to find the assets in a folder and fetch them in pages.

Log in requirement

Before being able to request information from Assets Server by using a GET request or make changes to the system through a POST request, a log in to Assets Server is required. For information about the available APIs for logging in, see Assets Server REST API - introduction.

Parameters

path

The path to the folder in Assets Server you want to list. Make sure the URL is properly URL-encoded, for example: spaces should often be represented as %20.

Required.
fromRoot

For returning multiple levels of folders with their children. When specified, this path is listed, and all folders below it up to the 'path' will have their children returned as well.

This ability can be used to initialize an initial path in a column tree folder browser with one server call.

Optional. When not specified, only the children of the specified 'path' will be returned.
includeFolders

Indicates if folders should be returned.

Optional. Default is true.
includeAsset

Indicates if files should be returned.

Optional. Default is true, but filtered to only include 'container' assets.
includeExtensions

A comma separated list of file extensions to be returned. Specify 'all' to return all file types.

Optional. Default includes all 'container' assets: .collection, .dossier, .task

Return value

An array of folders and assets in JSON format. Each item in the array has the following properties:

name The name of the asset or folder.
assetPath The full path of the asset or folder in Assets Server.
directory true or false. Indicates that this is a directory. If so, you can perform another browse call with the assetPath of this folder.
containerId Only available for container assets, for example a collection. If available, you can perform a search for items related to the specified collection id.

Examples

browse

http://demo.assets-server.com/services/browse
    ?path=/Demo Zone

Returns the subfolders of the Demo Zone:

[ 
    {
      "name" : "Archive",
      "directory" : true,
      "assetPath" : "/Demo Zone/Archive"
    }, {
      "name" : "Collections",
      "directory" : true,
      "assetPath" : "/Demo Zone/Collections"
    }, {
      "name" : "Images",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images"
    }, {
      "name" : "Office",
      "directory" : true,
      "assetPath" : "/Demo Zone/Office"
    }, {
      "name" : "Video",
      "directory" : true,
      "assetPath" : "/Demo Zone/Video"
    } 
]

browse

http://demo.assets-server.com/services/browse
    ?fromRoot=/
    &path=/Demo Zone/Images

Lists all folders from the root up to and including 'Demo Zone/Images':

[ 
  {
  "name" : "DAMTube",
  "directory" : true,
  "assetPath" : "/DAMTube"
  }, {
  "name" : "Demo Zone",
  "directory" : true,
  "assetPath" : "/Demo Zone",
  "children" : [ {
    "name" : "Archive",
    "directory" : true,
    "assetPath" : "/Demo Zone/Archive"
  }, {
    "name" : "Collections",
    "directory" : true,
    "assetPath" : "/Demo Zone/Collections"
  }, {
    "name" : "Images",
    "directory" : true,
    "assetPath" : "/Demo Zone/Images",
    "children" : [ {
      "name" : "Events",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images/Events"
    }, {
      "name" : "Food",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images/Food"
    }, {
      "name" : "Nature",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images/Nature"
    }, {
      "name" : "People",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images/People"
    }, {
      "name" : "Travel",
      "directory" : true,
      "assetPath" : "/Demo Zone/Images/Travel"
    }
 ]
  }, {
    "name" : "Office",
    "directory" : true,
    "assetPath" : "/Demo Zone/Office"
  }, {
    "name" : "Video",
    "directory" : true,
    "assetPath" : "/Demo Zone/Video"
  } ]
} 
]

browse

http://demo.assets-server.com/services/browse
    ?path=/Demo Zone/Images/Travel

Returns the sub items of the 'Demo Zone/Images/Travel' folder. In this case, the folder contains two collections:

[ 
      {
        "name" : "Architecture",
        "directory" : true,
        "assetPath" : "/Demo Zone/Images/Travel/Architecture"
      }, {
        "name" : "Cities",
        "directory" : true,
        "assetPath" : "/Demo Zone/Images/Travel/Cities"
      }, {
        "name" : "Landmarks",
        "directory" : true,
        "assetPath" : "/Demo Zone/Images/Travel/Landmarks"
      } 
]

Search content of folders and collections

Browse calls are only meant to be used for browsing folder structures. To display the actual assets residing in those folders and collections you need to use a search call.

To search for all assets in the Demo Zone and all its subfolders:

search

http://demo.assets-server.com/services/search
    ?q=ancestorPaths:"/Demo Zone"

To search for the assets located in /Demo Zone/Images. Assets in subfolders will not be returned:

search

 http://demo.assets-server.com/services/search
    ?q=folderPath:"/Demo Zone/Images"

To search for the contents of a collection using a relation search:

search

http://demo.assets-server.com/services/search
    ?q=relatedTo:5LMAQTW9qfhANn7f6JJVpl
    relationTarget:child
    relationType:contains

Related articles

Comments

0 comments