HiveSocial Gamification 1.0 API

The HiveSocial Gamification API gives you access to the HiveSocial Gamification event generation and information getting procedures.

The HiveSocial Gamification API is work in progress and we will gradually implement all available features and also some of the already implemented methods can change with the new API versions.

Date format

All dates (both those sent in requests and those returned in responses) should be formatted as presented in the examples. We support dates formatted ISO 8601 String. All dates are and should be in UTC time zone. (ex. "2013-02-04T22:44:30.652Z")

CORS

CORS, or cross-origin resource sharing, is a way to make XMLHttpRequests to another domain, different from the one that the script is loaded from. CORS is supported in most modern browsers.

API changes

All extensions of the API will be added only to the latest supported version. Bug fixes and optimizations will be applied to all relevant API versions. The API version is part of the base URL, so you will be able to choose which of API version you use for each of your requests.

API Base URL

You can make you RESTful requests by adding to your HiveSocial install domain the API path, based on the API version, locale, content item and methods. It should look like similarly to the following example:

https://<YOUR_DOMAIN>/rest/v1/en_US/<CONTENT_ITEM/<METHOD>/<PARAMETERS>

IMPORTANT: Secure certificate (https) is recommendable for the QListo API

Authorization

In order to provide the same level of security that we provide on our web software, many API requests are requiring authorization. This is done by providing an authorization token with the request. The token is returned by the Login API method and is usable in the next 8 hours. Example request with authorization should look like:

curl -H "x-api-auth-key:<YOUR_TOKEN>" <API_URL>

Authorization tokens cannot be revoked. The token can be managed from the application's webconfig file