Tutorials

Number of APIs: 9

To make it easy, we've created a Tutorials collection that allows you to follow our Data Model and Data Query tutorials in real time.

Refer to Alpine documentation for more details.

Getting started

Fork collection and environment into your workspace

To send requests or make changes to a collection from the Visier Alpine Platform workspace, you first need to fork the collection and environment into a personal or team workspace you belong to.

Note: Forking creates a copy of the collection in your Qodex workspace. The changes you make in a forked collection do not affect the original collection.

Configure forked environment

The Visier Alpine Platform environment includes variables that allow you to store and reuse values in Qodex.

After you've forked the environment, you can now update the current values before running your first request.

The following table defines each variable found in the environment.

NameDescription
usernameYour Visier username.
passwordYour Visier password.
baseUrlThe base URL is made up of the vanity name and domain name.

https://{vanityname}.api.visier.io

Replace {vanity
name} with your Visier tenant name.
apiKeyYour API key.
vanityNameYour Visier tenant name.

Here is an example of what your variables should look like:

VariableTypeIntitial ValueCurrent Value
usernamedefaultYour Visier username.john@jupiter.com
passworddefaultYour Visier password.12345678
baseUrldefaulthttps://{vanity_name}.api.visier.iohttps://jupiter.api.visier.io
asidTokendefault
apiKeydefaultYour API key.093c2808ae49427bae8e64e727c42118
vanityNamedefaultYour Visier tenant name.jupiter

Running a tutorial

To run all requests in a tutorial at once, click the More actions button on the right side of the tutorial's name and select Run folder.

Result: Qodex displays each request and result in a console.

  1. Get Aggregated Data Out of Visier-Steps - Request and retrieve metric objects GET {{baseUrl}}/v1/data/model/metrics

  2. Get Aggregated Data Out of Visier-Steps - Request and retrieve employeeCount metric GET {{baseUrl}}/v1/data/model/metrics/employeeCount

  3. Get Aggregated Data Out of Visier-Steps - Request and retrieve dimension objects GET {{baseUrl}}/v1/data/model/analytic-objects/Employee/dimensions

  4. Get Aggregated Data Out of Visier-Steps - Request and retrieve selection concepts GET {{baseUrl}}/v1/data/model/analytic-objects/Employee/selection-concepts

  5. Get Aggregated Data Out of Visier-Steps - Aggregate Query - CSV Response POST {{baseUrl}}/v1/data/query/aggregate

  6. Get a List of Records Out of Visier-Authentication - Generate Security Token POST {{baseUrl}}/v1/admin/visierSecureToken

  7. Get a List of Records Out of Visier-Steps - Request and retrieve employee properties GET {{baseUrl}}/v1/data/model/analytic-objects/Employee/properties

  8. Get a List of Records Out of Visier-Steps - List Query - CSV Response POST {{baseUrl}}/v1/data/query/list

  9. Get Aggregated Data Out of Visier-Authentication - Generate Security Token POST {{baseUrl}}/v1/admin/visierSecureToken