健康数据接入指南

将 Apple Health 数据连接到你的健康监控服务

中文
English
手环 → Mi Fitness
✓ 已连接
Mi Fitness → Apple Health
✓ 已连接
Apple Health → 服务器
● 待配置
1 配置快捷指令

📋 服务器地址 & 认证

快捷指令Shortcuts中需要用到以下信息,请复制保存:

// API 地址
https://health.jaredjen.xyz

// API Key (放在请求头 X-API-Key 中)
jared-health-2026
2 创建快捷指令

❤️ 上报心率

  1. 打开 iPhone 「快捷指令」Shortcuts App,点击右上角 +
  2. 搜索并添加 「获取健康样本」Find Health Samples,类型选 心率Heart Rate
  3. 设置时间范围为 过去 30 分钟Last 30 Minutes
  4. 添加 「字典」Dictionary 操作,构建 JSON:
    {
      "records": [{
        "bpm": 72,
        "timestamp": "2026-04-29T10:45:00+08:00"
      }]
    }
  5. 添加 「获取URL内容」Get Contents of URL
    • URL: https://health.jaredjen.xyz/api/heart-rate
    • 方法Method: POST
    • 请求头Headers: X-API-Key = jared-health-2026
    • 请求体Request Body: 上一步的字典

👟 上报步数

  1. 新建快捷指令,添加 「获取健康样本」Find Health Samples,类型选 步数Step Count
  2. 设置时间范围为 今天Today
  3. 添加 「获取URL内容」Get Contents of URL
    • URL: https://health.jaredjen.xyz/api/steps
    • 方法Method: POST
    • 请求体Request Body: { "count": 步数, "date": "YYYY-MM-DD" }

😴 上报睡眠

  1. 新建快捷指令,添加 「获取健康样本」Find Health Samples,类型选 睡眠分析Sleep Analysis
  2. 设置时间范围为 昨天Yesterday
  3. 添加 「获取URL内容」Get Contents of URL
    • URL: https://health.jaredjen.xyz/api/sleep
    • 方法Method: POST
    • 请求体Request Body: { "total_minutes": 总时长, "date": "YYYY-MM-DD", ... }

🩸 上报血氧 (可选)

  1. 新建快捷指令,添加 「获取健康样本」Find Health Samples,类型选 血氧饱和度Oxygen Saturation
  2. 时间范围 过去 30 分钟Last 30 Minutes
  3. POST 到 /api/blood-oxygen请求体Request Body: { "records": [{ "spo2": 98, "timestamp": "..." }] }
3 设置自动化
💡 推荐方案:快捷指令Shortcuts App → 自动化Automation 页面创建定时自动化:

心率 & 血氧Heart Rate & SpO₂每 30 分钟触发一次(全天)
步数Steps每小时触发一次(早 8 点 ~ 晚 11 点)
睡眠Sleep每天早上 8 点触发(读取前一晚数据)

⚠️ 自动化页面中记得关闭In Automation settings, turn off 「运行前询问」Ask Before Running,否则不会自动执行。, otherwise it won't run automatically.
连接测试

配置完快捷指令Shortcuts后,先手动运行一次确认数据能正常上传。也可以用下面的按钮测试服务器连通性: