Request Access to Data

If you build it, they will come.

A user without data is not very helpful, but we must ask their permission before we can obtain their data. To do this, we present the user with an application marketplace and guide them through the authentication process. This section will explain the process of configuring and deploying our marketplace.

📘

Concept: What is a Marketplace?

At Validic, the term "marketplace" is mostly symbolic. Instead of currency being exchanged, customers are granting permission to access their data. They access a marketplace, browse available devices and select one to connect to your solution.

For example, Jane Smith would like to use her Fitbit to participate in your wellness program. She'll access your Marketplace, select Fitbit and authorize the sharing of data.

The simplest way to integrate the Validic Marketplace is to use the Validic Standard HTML5 Marketplace. The Validic Marketplace handles all API app connections and callbacks.

To render the Validic Standard Marketplace to your users, you will use your Organization ID and the User Access Token created when you provisioned the user. You will create a button or link in your system that looks like this:

Open

When users select "Connect Your Device" they should be directed to:

To successfully make this request:

• You must include the "organization_ID" credentials provided by Validic

• You must include the "user_access_token" provided in the response when you provisioned your user

📘

FInding the User Access Token

The User Access Token is provided in the response when you provisioned your user. In the response, it is called an access_token. In our support documents, we refer to this as "user_access_token" so you do not confuse this with your organization access token. Confusing, we know. We'll likely change this in future versions of our API.

"user": {
"_id": "565c8821SAMPLE7000031",
"uid": "2039328aw38s",
"access_token": "rR8MThSAMPLEpVzkwdLv",
"profile": null

To preview our sample Validic Standard Marketplace, please click the button below:

Open

Custom App Marketplace Deployment

Our Enterprise customers may create a custom implementation of the Marketplace. To authenticate users, you will need your Organization’s ID, your Organization’s Access Token, and the User Access Token created when you provisioned the user.

Validic provides our Enterprise customers with one simple API call to access all of the appropriate URL’s and information needed to build the custom App Marketplace native to your platform, leveraging your existing look and feel, enabling you to create a consistent, cohesive user experience.

Please view our Custom Marketplace Tutorial for further information on deploying the App Marketplace, including example calls and a live demo of the Validic Standard HTML5 App Marketplace.