radarbase/radar-rest-fitbit

RADAR-REST-fitbit镜像说明

镜像概述

本镜像封装了RADAR-REST-fitbit应用，旨在轮询Fitbit Web API获取指定类型的健康数据（如步数、心率、睡眠等），并将采集到的数据发送至Kafka主题。支持通过配置文件和Web API灵活管理设备授权、数据采集频率及设备状态。

核心功能

• 轮询Fitbit API获取活动、心率、睡眠等健康数据；
• 将采集的数据推送至指定Kafka主题；
• 通过Web API控制数据轮询的启停；
• 管理已授权Fitbit设备（列出所有设备、停用设备、删除设备）；
• 可配置服务端口、Kafka地址、Fitbit认证信息等参数。

使用场景

• 健康数据采集与分析系统，整合Fitbit设备数据；
• IoT数据管道中Fitbit数据源的接入；
• 科研或健康管理项目中Fitbit数据的实时获取与存储。

配置说明

需修改容器内config/config.json文件的参数，关键配置项如下：

json
{
  "host": "http://localhost", // 应用部署地址
  "port": "3000", // 服务端口
  "fitbit": {
    "clientId": "你的Fitbit客户端ID",
    "clientSecret": "你的Fitbit客户端密钥",
    "apiVersion": "1.2",
    "callbackRoute": "/auth/fitbit/callback", // Fitbit回调路由
    "authRoute": "/auth/fitbit", // 授权初始路由
    "dataAuthorized": "activity heartrate location nutrition profile settings sleep social weight", // 授权的数据类型
    "authorizationHTML": "Fitbit授权成功！" // 授权成功页面显示内容
  },
  "poller": {
    "enabled": true, // 启动时是否自动开始轮询
    "frequency": "3000", // 轮询频率（毫秒）
    "routesPolled": [ // 需轮询的Fitbit数据路由
      {
        "resourcePath": "activities/steps",
        "date": "today",
        "period": "1d"
      }
    ],
    "enableWebRoutes": true, // 是否开启轮询控制的Web路由
    "stopPollingRoute": "/polling/stop", // 停止轮询的路由
    "startPollingRoute": "/polling/start" // 启动轮询的路由
  },
  "kafka": {
    "host": "http://localhost:9092" // Kafka服务地址
  },
  "sources": {
    "enableWebRoutes": true, // 是否开启设备管理的Web路由
    "deleteSourceRoute": "/sources/delete", // 删除设备的路由
    "deactivateSourceRoute": "/sources/deactivate", // 停用设备的路由
    "listAllSourcesRoute": "/sources/list" // 列出所有设备的路由
  }
}

Docker部署示例

单容器运行

bash
docker run -d \
  -p 3000:3000 \
  -v /本地配置目录:/app/config \
  docker.xuanyuan.run/radarbase/radar-rest-fitbit

说明：将本地配置目录挂载到容器内的/app/config（需确保该目录存在config.json文件），暴露3000端口供外部访问。

使用方法

1. 添加设备：
   更新config.json中的Fitbit clientId和clientSecret后启动容器，访问http://<容器地址>:3000/auth/fitbit完成设备授权。
2. 停止轮询：访问http://<容器地址>:3000/polling/stop
3. 启动轮询：访问http://<容器地址>:3000/polling/start
4. 列出所有设备：访问http://<容器地址>:3000/sources/list
5. 停用设备：访问http://<容器地址>:3000/sources/deactivate?user=<Fitbit用户ID>
6. 删除设备：访问http://<容器地址>:3000/sources/delete?user=<Fitbit用户ID>