健康数据上报 API

合作方通过 S2S 接口将健康站、可穿戴、手动录入等渠道的测量数据写入晓葆平台。 支持单条与批量上报，使用 client_request_id 实现幂等。

概述

接口路径前缀：/open/v1/health-data

鉴权说明

继承开放平台 S2S 中间件：AppKey + 签名。完整算法见鉴权说明。

用户识别规则

按 data_source 分支校验（跨字段规则）：

单条健康数据上报

支持渠道：manual / wearable / home /station / third_party / plugin。 幂等键为 client_request_id（同应用下重复提交返回 409， 响应携带原 measurement_no）。

请求体（application/json）：

station_user 对象：

indicators 单项：

请求示例：

POST /open/v1/health-data/submit
X-App-Id: 100023
X-Timestamp: 1743494400
X-Signature: ...
Content-Type: application/json

{
  "data_source": "wearable",
  "measured_at": "2026-07-20T10:30:00+08:00",
  "device_sn": "BP20240001",
  "device_model": "HOME_MULTI_BIO_MONITOR",
  "xiaobao_user_id": 10086,
  "client_request_id": "partner-req-20260720-001",
  "indicators": [
    { "code": "systolic_pressure", "value": 128, "unit": "mmHg" },
    { "code": "diastolic_pressure", "value": 82, "unit": "mmHg" }
  ]
}

成功响应（201 Created）：

{
  "success": true,
  "code": 0,
  "message": "健康数据上报成功",
  "data": {
    "measurement_no": "WD-20260720103000-A1B2C3",
    "validation_status": "valid",
    "claim_status": "claimed"
  },
  "timestamp": "2026-07-20T10:30:01+08:00"
}

data 字段说明：

批量健康数据上报

最多 50 条/次。每条独立处理，单条失败不影响其他条目。 条目字段与单条上报相同（嵌套在 measurements[] 内）。

请求体（application/json）：

请求示例：

POST /open/v1/health-data/submit-batch
X-App-Id: 100023
X-Timestamp: 1743494400
X-Signature: ...
Content-Type: application/json

{
  "measurements": [
    {
      "data_source": "wearable",
      "measured_at": "2026-07-20T10:30:00+08:00",
      "xiaobao_user_id": 10086,
      "client_request_id": "batch-001",
      "indicators": [
        { "code": "heart_rate", "value": 72, "unit": "bpm" }
      ]
    },
    {
      "data_source": "wearable",
      "measured_at": "2026-07-20T10:35:00+08:00",
      "xiaobao_user_id": 10086,
      "client_request_id": "batch-002",
      "indicators": [
        { "code": "spo2", "value": 98, "unit": "%" }
      ]
    }
  ]
}

成功响应（201 Created）：

{
  "success": true,
  "code": 0,
  "message": "批量上报完成",
  "data": {
    "total": 2,
    "success_count": 2,
    "failure_count": 0,
    "results": [
      {
        "index": 0,
        "success": true,
        "measurement_no": "WD-20260720103000-A1B2C3",
        "validation_status": "valid",
        "measured_at": "2026-07-20T10:30:00+08:00"
      },
      {
        "index": 1,
        "success": true,
        "measurement_no": "WD-20260720103500-D4E5F6",
        "validation_status": "valid",
        "measured_at": "2026-07-20T10:35:00+08:00"
      }
    ]
  },
  "timestamp": "2026-07-20T10:35:01+08:00"
}

results 失败项示例：

{
  "index": 1,
  "success": false,
  "error": "错误描述",
  "measured_at": "2026-07-20T10:35:00+08:00"
}

错误码