2025.3.4
首页 ▸ Integrations ▸

Withings

Withings integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 从 Withings 生产的各种健康产品中获取数据。

先决条件

  • Withings 帐户
  • 安装 Withings 应用
  • 在应用中设置 Withings 设备
  • Withings 开发者帐户 以获取 ClientID 和 Secret 来连接以获取 Withings 云 API 的数据

创建 Withings 开发者帐户

您必须拥有一个开发者帐户以分发数据。

Note

只需要一个开发者帐户。相同的帐户和凭据用于每个 Withings 配置。

  1. 创建一个免费的开发者帐户。
  2. 确保选择 Withings 公共云（而不是 Withings 美国医疗云或类似的）。
  3. 选择 创建应用。
  4. 在 应用创建 下，选择 公共 API 集成。
    • 阅读并接受条款，然后选择 下一步。
  5. 在 信息 下：
    • 目标环境：开发
    • 应用名称：[任何名称]
    • 应用描述：[任何描述]
    • 注册的 URL：https://my.home-assistant.io/redirect/oauth
      • 不要测试此 URL。此阶段无法使用。它将在您安装 Home Assistant 中的集成后设置。
    • 更改徽标：可选
  6. 保存 更改。
    • 保存后，ClientID 和 Secret 字段将被填充。
    • 复制并将其存储在安全的地方。您将在下一步中需要这些。
我已经手动禁用了 My Home Assistant

如果您在安装中没有 My Home Assistant， 可以使用 <HOME_ASSISTANT_URL>/auth/external/callback 作为重定向 URI。

<HOME_ASSISTANT_URL> 必须与配置/验证过程中的使用相同。

Withings 将在每次您保存 Withings 开发者帐户时验证这些要求（使用 HTTP HEAD）。当这些检查失败时，Withings 用户界面并不总是清楚原因。

  • Home Assistant（用于创建/更新 Withings 开发者帐户）：
    • 可公开访问。
    • 运行在完全限定的域名上。
    • 通过全球认可的证书颁发机构签署的 HTTPS 运行。Let’s Encrypt 将有效。

配置

要将 Withings integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Withings 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

数据更新

integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 自动检测您是否可以使用 Webhook。这使得 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 仅在有新数据时进行更新。 睡眠的二进制传感器仅在 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 可以与 Withings 建立 Webhook 时工作。

可用数据

integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 提供多个实体，其中一些在数据可用时动态启用。

例如，测量传感器如体重仅在过去 14 天内注册了数据时才有效。因此，如果您开始使用新设备，例如测量您的温度或您在应用中手动更新一个值，该传感器会自动出现。

仅在 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 能找到您在过去一天内的睡眠数据时，才会创建睡眠传感器。

锻炼日历和锻炼及活动传感器显示最新可用数据点不得超过 14 天。