A new API application is required to be created within the Perspio web app before you can successfully authenticate with any of the PerspioTalk endpoints. This application will be linked to the scope of a specific tenant where all associated consumption of the application will be associated.
PrerequisitesYou will need a user account with the administrator role to create a new application within Perspio. Please feel free to contact [email protected] for any user account questions.
PrerequisitesHead over to https://perspio.io/admin to create a new application
Add Service App Wizard (Perspio Admin)
- Click Add Application on the Admin / API page.
- Provide a meaningful Description of your application, then click Next
- Configure the access you want to grant to the new application
- Configure the restrictions you want to apply to the new application
ImportantThe client_secret will not change and is not retrievable after this step. You can always generate a new client_secret by managing the API application within Perspio. You will not be able to see this "secret" after you leave this screen.
- Retrieve the other unique values you will require from the application details screen.
Key Properties
- Application Client ID (
client_id)- Application Client Secret (
client_secret)- Perspio Tenant ID (
tid)- Perspio Tenant Subscription Key (
Ocp-Apim-Subscription-Key)
ImportantThese credentials can grant access to resources within your Perspio tenant. They must be kept secret and never used in publicly accessible code - this includes code repositories, distributed native application code and client-side code.
Once you have created your application, you need to record the key properties listed above to consume the PerspioTalk APIs.