Withings API icon

Withings API

Withings API Integration

Actions11

Measure → Get Activity

AI-generated

Overview

This node interacts with the Withings API to retrieve user intraday activity data under the 'Measure' resource with the 'Get Activity' operation. It is useful for scenarios where users want to fetch detailed activity metrics such as steps, calories, or other intraday measurements recorded by Withings devices. For example, it can be used to monitor daily physical activity or integrate activity data into health dashboards.

Use Case Examples

  1. Fetch intraday activity data for a user between specific start and end dates.
  2. Retrieve activity data updated after a certain timestamp to sync recent activity changes.

Properties

Name Meaning
Authentication Method Specifies how to authenticate with the Withings API, either using stored OAuth2 credentials or a manual access token from a previous node.
Access Token (From Previous Node) The access token string used for manual authentication, typically obtained from a previous token exchange node.
Additional Fields Optional parameters to refine the data retrieval, including start date, end date, last update timestamp, and offset to skip records.

Output

JSON

  • success - Indicates if the API call was successful.
  • resource - The resource type, here it will be 'measure'.
  • operation - The operation performed, here 'getactivity'.
  • data - The raw activity data returned from the Withings API.

Dependencies

  • Withings API
  • OAuth2 credentials or manual access token

Troubleshooting

  • Common issues include expired or invalid access tokens, which result in authentication errors. Refreshing OAuth2 tokens or providing a valid manual token resolves this.
  • API errors with status codes and messages are returned if the request parameters are invalid or the API service is unavailable.
  • Ensure date fields are correctly formatted as timestamps to avoid request errors.

Links

Discussion