|Important Information about this version|
The API version 2 is available as of Razuna 1.5 and on the hosted platform as of March 26th 2012 !!!
|API usage on the Hosted Platform|
If you use the API against the hosted Razuna platform, please make sure that your data plan is within your accounts bandwidth and storage quota. If your bandwidth or storage is exceeded any API operation will fail to work!
Welcome to the Razuna API (version 2)
Upgrading from API1 to API2
If you are coming from version 1 of the API, then there are a couple of changes, which are:
- The API works now with an API KEY (each user has an API key).
- The API is now based on REST calls only (no more SOAP).
- As data structure we return now JSON (default), JSONP or XML (WDDX).
- You can directly influence what data structure you want to return.
- Most methods return complete record sets.
- The API base URL is serverip/global/api2 !
- Please read the description of each method carefully, since we've made a lot of changes to the parameters.
In order to access the API you need to pass the API key with each method. The API key of each user can be found within the Razuna User dialog. Note: The current API implementation needs to work with a user in the Administrator group, thus only accounts within the Administrator group will have a API key displayed.
|Razuna Hosted Platform|
The URL for Razuna API on the Razuna Hosted Platform is: api.razuna.com.
API Method Request Format: API methods are encapsulated by web pages within the API web site. To call a method, make a POST or GET request to the web page corresponding to the method you want to execute.
When an API method is called, a response is returned to the caller in JSON (default), JSONP or XML (WDDX) format (WDDX (Web Distributed Data eXchange) is a established standard. More information is available over at WDDX at Wikipedia). By default, the API will return JSON. If you want to receive JSONP or XML you have to append "&__BDRETURNFORMAT=wddx" or "&__BDRETURNFORMAT=jsonp" to your call. NOTE: In order for JSONP to work you will need to append additionally "callback=?"!
Example JSON output (if a record set is being returned):
By default the API will return a ROW based JSON. If you want to use a COLUMNS you simply need to append the parameter "&__BDQUERYFORMAT=column" and the API will output:
The output for the above will be:
Available API Calls
The following API sections are available:
- Upload API2
- Search API2
- Asset API2
- Folder API2
- Collection API2
- Label API2
- Custom Fields API2
- User API2
- Hosts API2
- Comment API2
Requests to extend the Razuna API are welcomed. Please submit your request over at our public Request system at http://issues.razuna.com.