Authentication

The API is only accessible using secure HTTPS-connections.

A Client ID and API Token are required for accessing API resources. Users with an administrative role are able to view, create and remove these company-wide API credentials in the HappyOrNot reporting service Admin. If you don’t have access to the HappyOrNot Reporting service you should ask your HappyOrNot contact or our support at support@happy-or-not.com.

In authentication error cases the API will return appropriate response (HTTP 401 Unauthorized).

The API provides two authentication methods:

HTTP Basic Authentication

When using Basic Authentication, use the client identifier as username and API token as password.

GET /v1/folders HTTP/1.1
Content-Type: application/json; charset=UTF-8
Authorization: Basic Tm1JMk16ZzROemxqWldWaHpnNE46Tm1JMk16ZzROemxqWldWaHpnNE4=

HTTP Headers

The API has two headers reserved for authentication: X-HON-Client-Id and X-HON-API-Token.

GET /v1/folders HTTP/1.1
Content-Type: application/json; charset=UTF-8
X-HON-Client-Id: NmI2Mzg4NzljZWVhzg4N
X-HON-API-Token: Tm1JMk16ZzROemxqWldWaE1EWmpORGhpmxqWldWW