获取检测报告

用户完成健康站检测后,晓葆平台自动生成结构化检测报告并触发 AI 健康解读。 合作方可通过 Webhook 推送或主动查询两种方式获取报告数据。

报告生成流程

  1. 用户到站完成检测(各设备数据实时上报)
  2. 平台聚合本次到站的所有指标数据,生成健康站报告(station_report
  3. 若当日已有其他检测数据,合并生成健康日报(daily_report),触发 AI 解读队列
  4. AI 解读完成后,通过 Webhook 推送 health.daily_report.completed 事件
  5. 合作方 App 调用报告详情接口拉取完整数据
AI 解读通常在检测完成后 30 秒内完成。如需实时轮询, 可调用日报状态接口(/api/v1/health-data/daily-reports/{reportNo}/status)。

健康站报告列表

GET/api/v1/health-data/station-reports

返回当前用户(指定家庭成员)的所有健康站到访记录,按时间倒序分页。

查询参数

参数类型必填说明
family_member_idinteger指定家庭成员,不传默认返回当前用户本人
pageinteger页码,默认 1
page_sizeinteger每页数量,默认 20

健康站报告详情

GET/api/v1/health-data/station-reports/{aggregateId}

返回单次到站的完整报告,包含所有检测指标、趋势对比、AI 健康建议。

响应示例

{
  "success": true,
  "code": 0,
  "data": {
    "aggregate_id": "AGG20260401001",
    "points_code": "STA001",
    "points_name": "晓葆健康站(朝阳门店)",
    "measured_at": "2026-04-01 10:23:00",
    "measurements": [
      {
        "indicator_code": "blood_pressure",
        "indicator_name": "血压",
        "value": { "systolic": 125, "diastolic": 82 },
        "unit": "mmHg",
        "status": "normal",
        "reference_range": "< 130/80"
      },
      {
        "indicator_code": "heart_rate",
        "indicator_name": "心率",
        "value": 72,
        "unit": "bpm",
        "status": "normal",
        "reference_range": "60-100"
      }
    ],
    "ai_summary": "本次检测各项指标基本正常。血压轻微偏高,建议减少高盐饮食。"
  }
}

健康日报

健康日报将当日所有来源(健康站检测、手动录入、设备同步)的数据汇总, 生成综合性健康报告。每位家庭成员每天最多一份日报。

GET/api/v1/health-data/daily-reports

返回日报列表(按日期倒序),支持按家庭成员和月份过滤。

GET/api/v1/health-data/daily-reports/{reportNo}

返回日报完整内容,包含各设备 AI 解读和整体健康建议。 若 AI 解读尚未完成(ai_status: "processing"), 建议每 3 秒轮询状态接口。

GET/api/v1/health-data/daily-reports/{reportNo}/status

轻量级轮询接口,仅返回 AI 状态字段,用于前端等待 AI 解读完成。

AI 健康解读

用户可主动触发日报的 AI 重新解读(如手动补录数据后):

POST/api/v1/health-data/daily-reports/{reportNo}/interpret

触发后异步执行,可轮询 /status 接口等待结果。

报告数据结构

字段类型说明
ai_statusstringpending / processing / completed / failed
report_datestring报告日期(Y-m-d
family_member_idinteger所属家庭成员
measurementsarray各指标测量数据列表
device_reportsarray各设备的 AI 解读结果(Level1)
overall_ai_summarystring整体 AI 健康建议(Level2)
risk_indicatorsarray异常或需关注的指标