# 启辰云开放平台对接手册


依据云力开放平台.docx，版本 v20260901。本文未验证真实接口。


## 接入范围

第三方软件及硬件可在本地登记接入项目。云力文档提供测量数据查询接口，不等同于设备直连、上报或 HIS/EMR 接口。HIS/EMR 和其他设备需要厂商资料后实施适配。


## 环境与鉴权

https://health-openapi.zlyzn.com

POST /api/oauth/token；grant_type=client_credentials；client_id 为 int；client_secret 为 string。凭据需联系对接人员。

返回 token_type、expires_in（秒）、access_token。业务请求头 Authorization: Bearer {access_token}。示例 expires_in=1296000 为文档示例，实际以响应为准。


## 业务公共参数

- code：string；必传；手机号、身份证、社保号、门诊号、住院号或 barcode，与 type 对应

- type：int；必传；1 手机号；2 身份证；3 社保号；4 门诊号；5 住院号；6 barcode

- start_date：string；可选；Y-m-d H:i:s；不传默认所有数据

- end_date：string；可选；Y-m-d H:i:s；不传默认当前系统时间


## 单人血压

POST /api/v1/saas/bp

按患者标识查询血压与脉搏记录。

- dbp：integer；舒张压；单位：原文未注明

- sbp：integer；收缩压；单位：原文未注明

- pulse：integer；脉搏（每分钟次数）；单位：原文未注明

- measure_time：datetime；测量时间；单位：原文未注明


## 单人血糖

POST /api/v1/saas/bg

按患者标识查询血糖记录及进食状态。

- bg：decimal；血糖测量结果；单位：原文未注明

- dining_status：int；进食状态；单位：原文未注明；{"8": "凌晨", "1": "空腹", "2": "早餐后", "3": "午餐前", "4": "午餐后", "5": "晚餐前", "6": "晚餐后", "7": "睡前", "9": "随机测量"}

- measure_time：datetime；测量时间；单位：原文未注明


## 单人体征

POST /api/v1/saas/general_sign

文档标题为“获取单人温度”，同时返回体温、呼吸、脉搏及握力字段。

- temperature：string；体温；单位：原文未注明

- body_temperature_part：string；测量部位；单位：原文未注明；{"1": "腋温", "2": "口温", "3": "肛温", "4": "耳温", "5": "额温"}

- respiratory_rate：string；呼吸频率；单位：原文未注明

- pulse：string；脉搏；单位：原文未注明

- grip_power：string；握力；单位：原文未注明

- grip_strength_r：string；右手握力；单位：原文未注明

- grip_strength_l：string；左手握力；单位：原文未注明

- measure_time：datetime；测量时间；单位：原文未注明


## 单人血氧

POST /api/v1/saas/spo2

按患者标识查询血氧饱和度记录。

- spo2：decimal；血氧饱和度；单位：原文未注明

- measure_time：datetime；测量时间；单位：原文未注明


## 单人身高体重

POST /api/v1/saas/bmi

按患者标识查询身高、体重及 BMI。

- height：decimal；身高测量结果；单位：厘米（cm）

- weight：decimal；体重测量结果；单位：千克（kg）

- bmi：decimal；BMI 结果；单位：原文未注明

- measure_time：datetime；测量时间；单位：原文未注明


## 待厂商确认

请求 Content-Type；多数指标单位；错误码所在响应字段及 HTTP 状态；分页、限流和最大时间跨度；token 刷新和失效策略；体征握力字段标注非空但示例为空字符串；barcode 字段说明 string 但示例为数字。


## HIS 和 EMR 接入建议

以下为实施建议，非云力已提供接口：明确厂商与版本、数据授权、网络方式、患者主索引、门诊住院号、数据范围、增量游标、字典映射、单位、回写边界、重试幂等、审计及验收。根据厂商实际支持情况选择 REST、消息、文件或数据库适配；不预设已支持 HL7、FHIR、DICOM 等协议。


## 第三方硬件接入建议

优先通过厂商云接口，或由厂商提供网关/SDK。明确设备序列号、型号、协议版本、时间戳、患者绑定、数据单位和质量标记。当前附件未提供设备上报、设备注册或控制指令接口。


## 本地联调

平台沙箱仅返回固定合成数据，任何请求均不访问真实云力平台。Postman 集合是对接示例，需按实际授权与厂商编码要求配置后使用。