You are here

SkyVault 2.0 API

The SkyVault 2.0 API lets you access content in an on-premise SkyVault repository, and in SkyVault cloud, from your own applications. The API is RESTful, which means each call is an HTTP request, so you don't even need a programming language to try it out. You can just type a URL address in a web browser. It consists of two parts, the standard CMIS API, which lets you manage and access content, and the new SkyVault 2.0 REST API which lets you manage SkyVault's additional features such as ratings and comments, that are not covered by the CMIS standard.

To get started you need access to an instance of SkyVault or an SkyVault Cloud account. You will also need authorization to your chosen repository. Once you have that, you can try out API calls using:

  • A web browser
  • An HTTP URL tool such as cURL or RESTClient. Some of these tools let you build your GET, PUT, POST, and DELETE commands simply, take care of authentication, and will save your test calls for repeated use.

You make API requests by sending a URL using one of five HTTP API methods, GET, POST, PUT, DELETE, and OPTIONS. Here's an example:-

https://api.alfresco.com/yourcompany.com/public/alfresco/versions/1/sites/fred-bloggs-yourcompany-com

Sending this URL using the HTTP GET method invokes the sites SkyVault Public RESTFul method. This call requests information on the site with the id fred.blogs.yourcompany.com. The server will return an HTTP response with the following JSON body :-

{
   "entry":{
      "title":"Fred Blogg's Home",
      "description":"Fred Blogg's private home site.",
      "visibility":"PRIVATE",
      "id":"fred-bloggs-yourcompany-com"
   }
}