The Sentiance Backend speaks REST and GraphQL, both of which share the same authentication mechanism.
authorization header with content
Bearer <token> authenticates and authorizes your request. Based on what kind of token is supplied, the level of access is determined and could affect the functionality of various calls.
Authorization: Bearer e5c3b842284045d98ed042814f31543f
API Keys are a revocable, rotatable, scopeable key with which to query the API.
API Keys are generated on-demand with a name, scope, and expiry date and are disclosed to the creator only once. Please ensure the API Key is immediately stored somewhere secure.
A name can be given by the developer generating the key. The name is for visual purposes only and has no operational impact. Choose a name that would help you identify the key.
Scopes allow you to specify what operations an API Key can perform. Currently, we offer 3 different scopes: user.read, user.delete and user.link. We strongly suggest that you use multiple API Keys with limited scopes for different operations.
Use this scope to read user data. This scope should be used with the GraphQL and Rest APIs that are exposed by the sentiance platform to read user data.
Use this scope to delete a user along with all historical data. This scope should be used with the user delete API.
Use this scope to link third party users with a sentiance user. This scope should be used with the user link API.
For increased security, API Keys are self-expiring. The expiry time is 1 year (recently changed from 90 days) from time of creation. After 1 year, the old API Key will stop working and a new one will have to be created. We allow up to 10 active API Keys at any given time, per app. An active key is one that hasn't been revoked or expired.
You can manage your own API Keys from our developer portal. Our developer portal has all the tools you need, including a full history of API Keys created, revoked or expired. See it in action here.
Most of our clients are based on our European platform (even US and Australian clients) at
https://insights.sentiance.com. If you are using our US-based or Australian-based platform, please use respectively