Get Started
See below for the steps required to get started.
Getting an API Key
First, create a new App for production. By doing so, you will get a different API-Key which you can use for your production environment.
To get production access, it is important that both your account and App details are registered correctly.
Subscribe to the API products you want to use in the production environment.
Submit your request and contact us to request production access. Depending on the API, our API Services team might contact you to discuss the details of your request.
Once approved, you are ready to use our API in a live environment.
Authentication
The authentication for this API is done on the basis of access token. To obtain an access token, you need to call our OAuth API. The authentication mechanism can vary per API depending on the required level of authentication.
Environments
These are the URLs for the endpoints to get the tokens.
Sandbox: https://auth sandbox.connect.example.com
Production: https://auth.connect.example.com
OAuth Flows
Our APIs are secured using OAuth 2.0. This means you will need to pass an access token when making your request to the APIs. This page will explain how to obtain an access token. We use the following three flows for getting an access token: Client credentials, Authorization code flow and Refresh token.
If you want to go more in depth on some of the OAuth protocol, have a look at the OAuth RFC.
Consuming An API
When you have reached the stage of actually consuming one of our APIs, you will follow the below steps.
- Find an API from our documentation section
- Include your token/API key in your request as an Authentication header
- Include your token as a "Bearer" token in the "Authorization" header.
Ex:Authorization: Bearer 0b79bab50daca910b000d4f1a2b675d604257e42