Page Comparison

...

This guide details the Withings Pro and Inform APIs that clients will need to implement in order to create and manage the data connection between Withings Pro and Validic Inform on behalf of the end user.

...

The required steps are:

1. Provision a user in Validic Inform

2. Dropship and activate the cellular device using Withings Pro APIs

3. Establish the user device connection between Withings Pro and Validic Inform

4. Receive Withings Pro data in Validic Inform

...

1. Once this endpoint is used to submit the user’s Withings tokens to Validic Inform, Inform will be the source of truth for the tokens. Inform will update and manage the tokens to ensure data access is maintained, therefore, no other processes should make calls to Withings to adjust the tokens.

   1. If the tokens must be re-generated for any reason then the user must be disconnected from Withings Pro in Inform first. And then new tokens must be submitted to Inform using the “Establish User Device Connection“ endpoint.

2. All values are strings

3. scopes is an array of strings

4. Clients will calculate the expires_at date/time based on the time the Withings’ OAuth2-v2 Requesttoken response is received by adding Withings' expires_in to the response date/time.

5. expires_at format must match the following: YYYY-MM-DDTHH:MM:SSZ (e.g., 2023-07-12T23:00:00Z)

...

Sample Response

202 Accepted

Disconnect User

The Validic standard or custom marketplace is used to determine the user’s current connection status to Withings Pro. The Withings Pro source can be disconnected using the disconnect_url returned by the Validic marketplace, such as the following:

...