How to grant access to the Intelligence Analytics API
Using Mapp Intelligence with an API is a great way to retrieve all the business logic and information without needing to log in to our interface directly.
It enables retrieval data for all Mapp Intelligence analyses.
Analysis variants (such as time series, Cross-Table, and Path Analysis) and reports are not supported.
The Analytics API is an optional feature. Please contact your Customer Sucess Manager for activation.
Enable Access
Once the API is activated for your account, Client IDs need to be created to use and authenticate the API. For Accounts for which the API is not enabled, the API-KEY section is visible but the key generation is disabled.
Create an API Client ID and Client Secret
In order to create an API Client ID, go to Settings > API Client IDs. The Client IDs are bound to the person who created the Auth-Key.
Within API Client ID Overview you can:
Enter a description.
Add a Token validity time
The default Token validity time is 60 minutes. This security feature defines how often the user needs to request a new token. You can set a shorter window for higher security requirements.
A Client ID can be:
temporarily deactivated
revoked/deleted permanently
A Client ID and Client Secret can be copied to the clipboard at any time after creation from the overview table.
The Client ID is visible in clear text, while the Client Secret is not.
Authentication
As a Mapp Intelligence administrator, you can restrict and manage access to the API in the user management on the account level.
Authentication needs to be done using a Client-ID and Client Secret for an Intelligence account.
You will then receive a token. The token must be used with the API calls. It is valid until it is revoked or expired. (The activation status of the client id is not related to the function of the token).
If the API is disabled for an account, the authentication with an existing Client-ID will fail.
Check out the other articles to learn how to use the Analytics API with:
