Video - InEight Platform
API Getting Started

TRANSCRIPT

Hello and welcome. In this video, I'm going to walk you through how to use the Innate API developer portal, how to sign up, find API documentation, generate your subscription key, use the try it feature, and create bearer tokens via Microsoft's common endpoint for authentication.

By the end, you'll be ready to make your first API call.

Overview of Developer Portal Features

The developer portal is your central place to explore all of innate public rest APIs, both integration APIs and reporting APIs. It serves multiple purposes. You can view documentation, try out the APIs interactively, manage your access via subscription keys, and understand how authentication works.

Creating an Account

First, you'll need to sign up for an account.

Click sign up at the top right of the developer portal. If you already have credentials, use sign in.

Once you're signed in, you'll see a list of available APIs, groups and products, and documentation.

Understanding Subscription Keys

Before you can call many APIs, you'll need a subscription key. This key identifies your access and is required in the request header for many API endpoints.

First, we'll navigate to the products page.

Now here, you will see two options on my screen.

We have external integrations and platform.

Distinguishing Between API Types

The Platform APIs are the legacy set of APIs that are currently being sunset. The External Integration APIs is what you'll likely see with a new developer portal account. You may not see the Platform APIs options.

Selecting External Integrations

From here, you'll go ahead and select external integrations.

And then from here, you will enter a subscription name and then select the subscribe button.

Accessing Your Subscription Key

To access your subscription key, you will need to go to the profile page in the top right.

From here, you'll be able to see and manage all of your subscriptions.

You can regenerate these keys as well as show them so you can copy them for your API calls.