Skip to main content

Extra: Data sources

Show a connections page for other data sources inside the app.

Introduction​

This feature included in rook_sdk_apple_health allows developers to retrieve a list of available API data sources to build a custom connections page.

Xcode​

Go to the main Xcode section to see the IDE configuration.

Getting started​

Ios configuration​

Go to the main Ios configuration section to see the basic configuration.

Logging​

Go to the main Logging section to configure logs.

Usage​

Initialize​

Go to the main Initialize and Update userID sections to initialize.

Get data source authorizer​

To get the authorization url for a specific data source call getDataSourceAuthorizer:

  • If the user is not authorized, an authorizationUrl is provided, otherwise authorizationUrl will be null.

Allowed values: Garmin, Oura, Polar, Fitbit, Withings, Whoop, Dexcom.

void getDataSourceAuthorizer() async {
  try {
    final authorizer = await AHRookDataSources.getDataSourceAuthorizer(
      dataSource,
      redirectUrl: null,
    );

    final url = authorizer.authorizationUrl;

    // Open url in a web view or web browser
  } catch (error) {
    // Handle error
  }
}

Get authorized data sources​

To get all authorized data sources for the current user getAuthorizedDataSources:

Please note that this only represents the user authorization status, and not whether the data source is currently active (sending data) or not.

void getAuthorized() async {
  try {
    final authorizedDataSources = await AHRookDataSources.getAuthorizedDataSources();

    // Success
  } catch (error) {
    // Handle error
  }
}
tip

The properties of the AuthorizedDataSources are nullable to differentiate between available and unavailable data sources.

To unlink (revoke authorization) from a data source call revokeDataSource:

Allowed values: Garmin, Oura, Polar, Fitbit, Withings, Whoop, Dexcom.

void revoke() async {
  try {
    await AHRookDataSources.revokeDataSource("Fitbit");

    // Success
  } catch (error) {
    // Handle error
  }
}

Pre-built connections page​

If you don't want to create your own connections page, you can use our pre-built screen by calling presentDataSourceView:

  • redirectUrl (Optional) - After the user successfully connects to a data source, the user will be redirected to this URL.
void showDataSources() {
  AHRookDataSources.presentDataSourceView();
}