Authentication
Data Integrity Suite's APIs provide multiple authentication methods. Whether you want to pass the API Key and Secret directly using a custom authorization header or authenticate using a bearer token, you can do either using an authorization header.
The three ways of authentication are:
- Sign In to Developer Portal
- Using API Key and Secret
- Using bearer token
The last two methods use the HTTP Authorization header, enabling seamless integration depending on your security preferences and technical setup.
Related guide: How to Authenticate
Sign In
Signing in to the Developer Portal automatically generates a bearer token, logging you in and providing instant access to the Data Integrity Suite APIs. If you don't have an account, start a free trial now.
Sign in to the Developer PortalUsing API Key and Secret
This method eliminates the need to generate and manage tokens. After receiving your credentials, pass the API Key and Secret using a custom authorization header.
- Before using the below API, ensure you generate your API key and API secret from Data Integrity Suite (Account > API Keys).
- Encode the API Key and Secret in Base64 format as
Base64(ApiKey:ApiSecret) - Use the encoded string in the "Authenticate with API Key" dialog on the API tryout page.
Authorization: Basic base64(Key + ":" + secret)Using bearer token
This endpoint generates an access-token based on the provided access keys. The access token is transmitted in the HTTP Authorization header as a bearer token.
- Use the Request access token endpoint to obtain an access token.
- Pass the API Key and Secret as a Basic Authentication header (
Base64(api_key:api_secret)). - Select the above endpoint and click Send in your Postman interface.
- Analyze the response and copy the token.
- Include the copied token in the "Authorize with bearer token" dialog as
access-tokenon the API tryout page.
The token expires one hour after it is generated. Ensure you use the token within this timeframe to avoid authentication issues.
Authorization: Bearer <access-token>Error Codes
| Error Code | Description |
|---|---|
| DIS-1003 | Issue with internal services |
| DIS-AUTH-1002 | Invalid API key |
| DIS-AUTH-1003 | Invalid API Secret |
| DIS-AUTH-1016 | Invalid grant_type |
| DIS-AUTH-1018 | Invalid request body |
| DIS-AUTH-1019 | Request body is not specified |
| DIS-AUTH-1020 | Authorization header is not provided |
| DIS-AUTH-1021 | Invalid scope value |
| DIS-AUTH-1022 | Workspace has been expired |