跳转到主要内容
Mirobody 提供 Garmin、Oura 和 WHOOP 集成。每套部署都需要向厂商申请自己的开发者凭据。 Apple Health 使用独立的文件导入与客户端推送方式。

接入步骤

  1. 在厂商开发者平台中注册应用。
  2. 为部署配置可公开访问的 HTTPS 回调地址。
  3. 将凭据写入生效的配置覆盖文件,不修改随包提供的默认配置。
  4. 应用配置后,在 Web 客户端中完成账号授权。
回调地址格式:
厂商平台登记的回调地址必须与配置完全一致。Oura、WHOOP 使用 OAuth 2.0, 当前 Garmin 集成使用 OAuth 1.0a。

配置示例

Docker 部署应将配置写入由 ENV 和 MIROBODY_CONFIG_FILE 选定、并已挂载的覆盖文件。 修改仓库中的 config.devices.yaml 不会改变已有镜像里的配置,详见配置说明。

检查同步

运行 docker compose up -d 应用修改,再查看应用和 worker 的日志:
缺少凭据时,相应 provider 不会启用。授权失败先核对回调地址和凭据; 授权成功却没有数据时,检查 worker 状态与数据库连接。 开发者平台、可选参数和厂商差异见完整接入参考。