获取检测报告
用户完成健康站检测后,晓葆平台自动生成结构化检测报告并触发 AI 健康解读。 合作方可通过 Webhook 推送或主动查询两种方式获取报告数据。
报告生成流程
- 用户到站完成检测(各设备数据实时上报)
- 平台聚合本次到站的所有指标数据,生成健康站报告(
station_report) - 若当日已有其他检测数据,合并生成健康日报(
daily_report),触发 AI 解读队列 - AI 解读完成后,通过 Webhook 推送
health.daily_report.completed事件 - 合作方 App 调用报告详情接口拉取完整数据
AI 解读通常在检测完成后 30 秒内完成。如需实时轮询, 可调用日报状态接口(
/api/v1/health-data/daily-reports/{reportNo}/status)。健康站报告列表
GET/api/v1/health-data/station-reports
返回当前用户(指定家庭成员)的所有健康站到访记录,按时间倒序分页。
查询参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
family_member_id | integer | 否 | 指定家庭成员,不传默认返回当前用户本人 |
page | integer | 否 | 页码,默认 1 |
page_size | integer | 否 | 每页数量,默认 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_status | string | pending / processing / completed / failed |
report_date | string | 报告日期(Y-m-d) |
family_member_id | integer | 所属家庭成员 |
measurements | array | 各指标测量数据列表 |
device_reports | array | 各设备的 AI 解读结果(Level1) |
overall_ai_summary | string | 整体 AI 健康建议(Level2) |
risk_indicators | array | 异常或需关注的指标 |