Overview

This node interacts with the Withings API to retrieve information about user devices. It supports authentication via OAuth2 credentials or a manual access token. The node allows specifying additional fields such as start date, end date, last update, and offset to filter the device data retrieved. It is useful for scenarios where you need to access and manage data about devices linked to a Withings user account, such as fetching device details for monitoring or integration purposes.

Use Case Examples

1. Fetching all devices associated with a user's Withings account to display device information in a dashboard.
2. Retrieving device data updated after a specific date to sync with another health tracking system.

Properties

Output

JSON

• success - Indicates if the API call was successful.
• resource - The resource type, here it will be 'user'.
• operation - The operation performed, here it will be 'getdevice'.
• body - The response body from the Withings API containing device data.
• data - Alternative field containing the device data if 'body' is not present.

Dependencies

• Withings API
• OAuth2 credentials or manual access token

Troubleshooting

• Ensure the access token is valid and not expired when using manual authentication; otherwise, the node will throw an authentication error.
• If the OAuth2 token is expired, the node attempts to refresh it automatically; failure to refresh will result in an error requiring re-authentication.
• API errors from Withings are returned with status codes and error messages; check the error details for troubleshooting.

Links

• Withings API Documentation - Official documentation for Withings API endpoints and usage.