Connection¶
A connection is a link between Dimdata and a 3rd party service or app. The OAuth 2.0 connection handles the token exchange automatically.
When working with the Dimdata APIs, your app will access Dimdata on behalf of your users. You'll need to have each user of your app sign into dimdata.com to grant your app permission to access their data on Dimdata.
Dimdata API is designed for application partners and customers.
Note
Dimdata supports OAuth 2.0 only. Before you start configuring your OAuth2.0 connection, you need to register your application via https://app.dimdata.com/developer. If you don't have a registered application or your application status is waiting for approval, you can use Postman for development purposes and testing APIs by follow Getting Started guide below. You also need an Dimdata account with any plan to test as end-user consent.
Learn more API Reference
Getting Started development with Postman¶
Authorization and request access token with Postman
| Field | Description |
|---|---|
| Grant Type | Authorization Code (With PKCE) |
| Callback URL | https://oauth.pstmn.io/v1/callback (Authorize using browser) |
| Auth URL | https://account.dimdata.com/connect/authorize |
| Access Token URL | https://account.dimdata.com/connect/token |
| Client ID | postmanapi |
| Code Challenge Method | SHA-256 |
| Code Verifier | Blank (Automatic) |
| Scope | email dimdataApi |
Note
Scope offline_access is not allowed with this Client ID
Testing your authorization token by calling this API¶
GET https://webapi.dimdata.com/api/getuserinfo
Get customer account and user information
curl --location --request GET '/api/getuserinfo' \
--header 'authorization: bearer [accesstoken]' \
| Responses | |
|---|---|
| 200: OK | Returns customer account and user information |
| 400: Bad Request | If customer not found |