Web Services Overview

All web services are available for use through any HTTP client, such as cURL for the command line, or any language specific library that can perform HTTP Requests, such as Requests for python or Apache HttpClient for Java.

All services are served from the URL https://ws.aculabcloud.net. The service actions make up the path of the final URL. i.e. https://ws.aculabcloud.net/file_list for the File List service.

When accessing a web service using an HTTP client, the following conditions apply unless otherwise stated in the documentation for that service.


The format for the username and password is as follows:

Username:cloudID/username (e.g. 1-2-0/​user@​example.com)
Password:cloud account password

For example:

$ curl --user 1-2-0/user@example.com:​password ​https://ws.aculabcloud.net/​file_list?​filetype=​media

Time Units

Several services return time properties. Unless otherwise documented these are specified in seconds since the Unix epoch UTC, 1st January 1970 00:00, where UTC is the Coordinated Universal Time.

Cost Units

All costs are returned in US dollars and cents.

Web Service Errors

Many of the web services will return HTTP standard response codes (e.g. 404 Not Found) if the service cannot carry out the requested action. In addition these web services may return a four digit error code that provide specific detail of the error encountered. These are described here.

 We provide wrappers in a number of high-level languages to make writing your applications easier. We recommend using these for all but the most basic testing.