Skip to content

Usage Intelligence Reporting API (3.0.0)

The Usage Intelligence Reporting API is targeted for advanced users who would like to build their own dashboards or integrate Usage Intelligence reporting (charts or raw data) within third party applications. The API can also be used to export data and statistics out of the Usage Intelligence servers for archiving or custom processing by other solutions.

NOTE: For information on global filters and segmentation in API reporting, see Global Filters and Segmentation and Levels (Date-Range Reports).

For Developer: To access our APIs programmatically, begin by obtaining the CSRF cookie. Send a GET request to the /v3/request-csrf endpoint with the appropriate headers, as specified in the auth API. Upon success, you'll receive a 204 status code. Then, utilize this obtained cookie when while using the auth API. After successful authentication, you'll receive two cookies: RUI-Csrf and RUI-Session-Token. Keep these cookies for subsequent requests. If authentication fails, expect to receive a 401 error code.

NOTE: The value for Origin should be https://analytics.revenera.com for all API endpoints. Providing a different value will result in an error.

Explore the APIs Using Postman

To help you get hands-on experience with our APIs, we have provided a Postman collection for download. This collection will allow you to seamlessly test and explore the API endpoints in a familiar environment.

How to explore APIs using Postman:

  1. Download the Postman Collection: Download
  2. Import into Postman: Open your Postman app and import the collection.
  3. Authenticate: Replace the "username" and "password" placeholders with your credentials (the same ones used in the Usage Intelligence Dashboard at https://analytics.revenera.com) in the /auth/web API endpoint body, then click Send.
  4. Personalize: Replace the demo "product_id" in the API endpoints with your own "product_id" and modify the sample payload as per your product’s requirements.

Start exploring the APIs!

Download OpenAPI description
v3_api_redocly.json
v3_api_redocly.yaml
Languages
Servers
Mock server
https://rui-api.redocly.app/_mock/v3_api_redocly
https://analytics-api.revenera.com

Auth

Operations

Authenticate

Request

Before being able to request any data, one needs to authenticate with the API. If authentication is not done, further requests will be rejected and 401 error code will be returned.

NOTE: If you encounter “Cookie Missing” error, retry the request you should be able to authenticate.

Headers
Content-Typestring
Example: application/json
RUI-Clientstring
Example: Postman
RUI-Client-Versionstring
Example: 0.0.1
Originstring
Example: https://analytics.revenera.com
Bodyapplication/jsonrequired
userNamestring
Example: "test@test.com"
passwordstring
Example: "helloTest"
curl -i -X POST \
  https://rui-api.redocly.app/_mock/v3_api_redocly/v3/auth/web \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://analytics.revenera.com' \
  -H 'RUI-Client: Postman' \
  -H 'RUI-Client-Version: 0.0.1' \
  -d '{
    "userName": "test@test.com",
    "password": "helloTest"
  }'

Responses

OK

Headers
Serverstring
Example: "nginx/1.20.1"
Datestring
Example: "Thu, 25 May 2023 13:02:01 GMT"
Content-Typestring
Example: "application/json"
Content-Lengthinteger
Example: "1686"
Connectionstring
Example: "keep-alive"
Access-Control-Allow-Originstring
Example: "https://analytics.revenera.com"
Access-Control-Allow-Credentialsboolean
Example: "true"
Varystring
Example: "Origin"
Rui-Apistring
Example: "RUI Admin API (3.0.0.dev14)"
Rui-Libstring
Example: "3.0.0.dev25"
Set-Cookiestring
Example: "RUI-Session-Token=y8bN4N6Sudn0OuN1wt6VsDROVQqX_-fL; HttpOnly; Max-Age=39600; Path=/; SameSite=Strict; Secure"
X-XSS-Protectionstring
Example: "1; mode=block"
X-Content-Type-Optionsstring
Example: "nosniff"
Referrer-Policystring
Example: "no-referrer-when-downgrade"
Bodyapplication/json
object
Response
application/json
{
  "account": {
    "name": "test",
    "surname": "user",
    "email": "testuser@test.com",
    "emailVerified": true,
    "userToken": "5122ccd6b994VRSS223W6Z0U",
    "isSocialUser": false,
    "readTos": 1
  },
  "freeware": {
    "canAddFreeProduct": true,
    "limit": 10
  },
  "products": {
    "2376158762": { … },
    "2395188568": { … }
  },
  "userSettings": {
    "defaultProduct": null,
    "currentProduct": "2376158762"
  },
  "currentProductDetails": {
    "permissions": { … },
    "config": { … }
  },
  "beatInterval": 302
}

Logout

Request

In order to log out, it is required to invalidate the user session that was created when logging in. If cookies are being used, the cookie will also be invalidated. Two options for logging out are being offered - either invalidate a single session or else, invalidate all sessions that are active on your user ID.

Headers
Content-Typestring
Example: application/json
RUI-Clientstring
Example: Postman
RUI-Client-Versionstring
Example: 0.0.1
Originstring
Example: https://analytics.revenera.com
Bodyapplication/json
string
curl -i -X POST \
  https://rui-api.redocly.app/_mock/v3_api_redocly/v3/auth/logout \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://analytics.revenera.com' \
  -H 'RUI-Client: Postman' \
  -H 'RUI-Client-Version: 0.0.1' \
  -d '{}'

Responses

No Content

Bodyapplication/json
Response
application/json
null

Metadata Queries

Operations

Event Tracking Management

Operations

Generic Reports

Operations

User Engagement Histogram

Operations

Event Tracking Reports

Operations

License Key Registry Management

Operations

Custom Event Tracking

Operations

Exception Tracking

Operations

Client Profile Report

Operations

Raw Data Exports

Operations