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. email@example.com)|
|Password||:||cloud account password|
$ curl --user firstname.lastname@example.org:password https://ws.aculabcloud.net/file_list?filetype=media
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.
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.