Devices API

​

Overview

Getting started with our Devices API is pretty easy, you’ll just need take the following steps:

1. Create a developer account.
2. Generate an API key.
3. Integrate your app with Metriport.
4. Link to the Metriport Connect widget in your app.
5. Access your users’ health data 🎉🎉🎉

Feel free to follow along with this overview video as well, or just watch it before getting started to get an idea of the expected result:

Let’s get into it! 🤘

​

1. Create a developer account

​

2. Generate an API key

Once you’ve created an account and confirmed your email, you’ll be taken to the dashboard home page. From here, take the following steps to get your API key:

• In the left hand menu, click Products & Billing.
• Click Get Started on the Device API product, and add your payment info.
• In the left hand menu, click Developers.
• On the Developers page, you’ll be able to click the Generate Secret Key button.

​

3. Integrate your app with Metriport

There are two ways to receive data from Metriport:

• API: Your app requests data from Metriport:
  • your application polls Metriport for user data, for a specific date;
• Webhook: Metriport sends data to your app when it becomes available:
  • your application exposes a webhook (endpoint), which Metriport calls when there’s more user data available;
  • note that this is the only way to get information from Garmin and Apple Health (you can see what providers support Webhooks here);
  • to learn more about how the Webhook flow works, see our Webhooks guide.

​

3.1 API: setup the Metriport client on your server

If you’re using Node, you can use the Metriport SDK to simplify calling Metriport’s API.

In the root of your server project, run the following terminal command to install the SDK:

npm install --save @metriport/api-sdk

From here, all you need to do is to initialize a Metriport client instance using your API key, and you’re good to start making requests to the Metriport API from your server:

import { MetriportDevicesApi } from "@metriport/api-sdk";

const metriportClient = new MetriportDevicesApi("YOUR_API_KEY", {
  sandbox: false, // set to true to use the sandbox environment
});

If you don’t want to use the SDK, you can also make requests to the Metriport API directly. Head to the API reference to learn more about the available endpoints.

​

3.2. Webhook: expose an endpoint to be called by Metriport

This allows your application to receive user data as soon as it becomes available, removing the need to poll Metriport’s API at regular intervals.

It’s the only and required way to get information from Garmin and Apple Health.

Head to the webhook page to learn how to setup this integration with Metriport.

​

4. Link to the Metriport Connect Widget in your app

With Metriport, you get a pre-built Connect Widget that you can easily plug into your app, so that your users can connect all of their data sources to your application! Here’s a preview:

To hook this up, on your server you’ll just need to create each user in Metriport, and generate a temporary token for each Connect session:

// create user in Metriport and get the Metriport user ID
const metriportUserId = await metriportClient.getMetriportUserId("your-internal-user-id");

// create a session token to be used in the Metriport Connect widget
const connectToken = await metriportClient.getConnectToken(metriportUserId);

Then, in your application’s front end, simply link to the Metriport Connect widget and pass in that session token you generated above:

window.open(`https://connect.metriport.com/?token=${connectToken}`);

`https://connect.metriport.com/?token=${connectToken}&sandbox=true`;

Head to the Connect Widget page to learn more about the various Widget customization options, and view some code samples for integrating the Widget on different platforms such as iOS and Android.

​

5. Access your user’s health data 🎉🎉🎉