DB32/T 5197-2025 糖尿病健康医疗数据接口与数据传输要求

　　糖尿病健康医疗数据接口与数据

　　传输要求

　　Requirements for interface and data transmission of diabetes

　　health medical data

　　2025‑09‑10 发布2025‑10‑10 实施

　　DB32/T 5197—2025

　　前言……………………………………………………………………………………………………………Ⅲ

　　1 范围…………………………………………………………………………………………………………1

　　2 规范性引用文件……………………………………………………………………………………………1

　　3 术语和定义…………………………………………………………………………………………………1

　　4 缩略语………………………………………………………………………………………………………1

　　5 数据接口……………………………………………………………………………………………………2

　　6 数据传输……………………………………………………………………………………………………7

　　附录A(资料性) 服务接口请求响应状态码………………………………………………………………10

　　前言

　　本文件按照GB/T 1.1—2020《标准化工作导则　第1 部分：标准化文件的结构和起草规则》的规定

　　起草。

　　请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

　　本文件由江苏省卫生健康委员会提出并组织实施。

　　本文件由江苏省卫生健康标准化技术委员会归口。

　　本文件起草单位：南京大学、江苏省疾病预防控制中心。

　　本文件主要起草人：张峻峰、张文红、徐佳南、陈斯蕾、胡伟、徐金水、郭海建。

　　Ⅲ

　　DB32/T 5197—2025

　　糖尿病健康医疗数据接口与数据

　　传输要求

　　1 范围

　　本文件规定了糖尿病健康医疗数据接口与数据传输的相关要求。

　　本文件适用于区域糖尿病健康医疗数据的传输，其它慢性疾病的数据接口和传输可参照使用。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文

　　件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本

　　文件。

　　GB/T 31504　信息安全技术　鉴别与授权　数字身份信息服务框架规范

　　GB/T 38672　信息技术　大数据 接口基本要求

　　DB32/T 4155.1—2021　全民健康信息平台共享数据集规范　第1 部分：基本健康档案

　　DB32/T 4155.2—2021　全民健康信息平台共享数据集规范　第2 部分：慢病管理

　　DB32/T 4155.6—2021　全民健康信息平台共享数据集规范　第6 部分：医疗检验检查

　　DB32/T 4155.7—2021　全民健康信息平台共享数据集规范　第7 部分：医疗门诊

　　3 术语和定义

　　本文件没有需要界定的术语和定义。

　　4 缩略语

　　下列缩略语适用于本文件。

　　JSON：JS 对象标记(Java Script Object Notation)

　　URL：统一资源定位符(Uniform Resource Locator)

　　XML：可扩展标记语言(Extensible Markup Language)

　　5 数据接口

　　5.1 接口方式

　　5.1.1 接口采用IETF RFC 2616 的HTTP 协议进行传输，数据交换格式宜为JSON 格式，请求头宜采

　　用Content‑Type： application/json，并通过POST/GET/PATCH 等方式访问。

　　5.1.2 通过统一的接口地址提供不同服务的接入，使用服务标识区分。

　　5.1.3 接口地址设计为HTTP[S]：//URL_ADDR[：PORT]/API/SERVICE/。

　　5.1.4 接口符合GB/T 38672 的技术要求。

　　1

　　DB32/T 5197—2025

　　5.2 参数类型

　　参数类型是所有允许取值的数据类型的表达，数据类型应符合表1 的规定。

　　表1　请求参数数据类型

　　数据类型

　　字符串型

　　整数型

　　浮点数型

　　布尔型

　　日期型

　　日期时间型

　　表示方法

　　string

　　int

　　double

　　bool

　　date

　　datetime

　　备注

　　使用符合UTF‑8 编码的字符串

　　32 位有符号整数

　　使用双精度浮点数存储小数

　　使用0 和1 表示假值与真值

　　YYYYMMDD 表示日期

　　YYYYMMDDhhmmss 表示日期时间具体到s

　　5.3 接口类型

　　5.3.1 数据管理接口

　　5.3.1.1 健康档案新建

　　5.3.1.1.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案新建，

　　支持批量操作，并获取操作结果;数据需要即时同步。

　　5.3.1.1.2 健康档案新建服务的接口请求和接口响应分别见表2 和表3。

　　表2　健康档案新建接口请求

　　参数

　　服务标识

　　方法

　　数据类型

　　请求体

　　值

　　UserArchive

　　POST

　　application/json

　　ArchiveData，格式按照DB32/T 4155.1—2021 的表4 进行编写

　　2

　　DB32/T 5197—2025

　　表3　健康档案新建接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.1.2 健康档案更新

　　5.3.1.2.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案更新，

　　支持批量操作，并获取操作结果;数据需要即时同步。

　　5.3.1.2.2 健康档案更新服务的接口请求和接口响应分别见表4 和表5。

　　表4　健康档案更新接口请求

　　参数

　　服务标识

　　方法

　　数据类型

　　请求参数

　　请求体

　　值

　　UserArchive

　　PATCH

　　application/json

　　证件类型

　　证件号

　　ArchiveData，格式按照DB32/T 4155.1—2021 的表4 进行编写

　　personcardType

　　personcardNo

　　表5　健康档案更新接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.1.3 随访数据新建

　　5.3.1.3.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据新建，

　　支持批量操作，并获取操作结果;数据需要即时同步。

　　5.3.1.3.2 随访数据新建服务的接口请求和接口响应分别见表6 和表7。

　　表6　随访数据新建接口请求

　　参数

　　服务标识

　　方法

　　数据类型

　　请求体

　　值

　　FollowUpArchive

　　POST

　　application/json

　　ArchiveData，格式按照DB2/T 4155.2—2021 的表4 和表5 进行编写

　　3

　　DB32/T 5197—2025

　　表7　随访数据新建接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.1.4 随访数据更新

　　5.3.1.4.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据更新，

　　并获取操作结果;数据需要即时同步。

　　5.3.1.4.2 随访数据更新服务的接口请求和接口响应分别见表8 和表9。

　　表8　随访数据更新接口参数

　　参数

　　服务标识

　　方法

　　数据类型

　　请求参数

　　请求体

　　值

　　FollowUpArchive

　　PATCH

　　application/json

　　证件类型

　　证件号

　　医院代码

　　随访时间

　　ArchiveData，格式按照DB32/T 4155.2—2021 的表4 和表5 进行编写

　　personcardType

　　personcardNo

　　hospitalId

　　followUpDate

　　表9　随访数据更新接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.1.5 用药处方接收

　　5.3.1.5.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理用药处方，支持

　　批量操作，并获取操作结果;数据需要即时同步。

　　5.3.1.5.2 用药处方接收服务的接口请求和接口响应分别见表10 和表11。

　　表10　用药处方接收的接口请求

　　服务标识

　　方法

　　Prescription

　　POST

　　参数值

　　4

　　DB32/T 5197—2025

　　数据类型

　　请求体

　　application/json

　　PrescriptionData，数据结构按照DB 32/T 4155.7—2021 中表10 及表11 进行填写

　　表10　用药处方接收的接口请求 (续)

　　参数值

　　表11　用药处方接收接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.1.6 健康教育处方接收

　　5.3.1.6.1 接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康教育处方，

　　支持批量操作，并获取操作结果;数据需要即时同步。

　　5.3.1.6.2 健康教育处方接收服务的接口请求见表12，接口请求体的具体数据结构请见表13，接口响应

　　见表14。

　　表12　健康教育处方接收接口请求

　　参数

　　服务标识

　　方法

　　数据类型

　　请求体

　　值

　　Caring

　　POST

　　application/json

　　CaringData

　　表13　健康教育处方数据结构

　　患者证件号

　　门诊 ID

　　疾病名

　　机构

　　科室

　　医生证件号

　　开单时间

　　营养建议

　　运动建议

　　PAT_ID

　　OUTPAT_ID

　　DISEASE_NAME

　　INSTITUTION

　　DEPARTMENT

　　DOCTOR_ID

　　PRESCRIPTION_DATETIME

　　NUTRITION_PRESCRIPTION

　　EXERCISE_PRESCRIPTION

　　VC

　　VC

　　VC

　　VC

　　VC

　　VC

　　DT

　　TEXT

　　TEXT

　　18

　　12

　　100

　　100

　　50

　　18

　　14

　　—

　　—

　　是

　　是

　　是

　　是

　　是

　　是

　　是

　　是

　　是

　　身份证号格式，必须唯一

　　门诊识别号

　　疾病名称

　　医疗机构名称

　　科室名称

　　医生的身份证号

　　日期时间格式YYYYMMDDhhmmss

　　针对特定健康问题的建议或指导

　　针对特定健康问题的运动建议

　　字段名英文名类型长度必填备注

　　5

　　DB32/T 5197—2025

　　用药指导

　　心理指导

　　其它指导

　　下次就诊时间

　　MEDICINE_PRESCRIPTION

　　MENTAL_PRESCRIPTION

　　OTHER_PRESCRIPTION

　　NEXT_VISIT_DATE

　　TEXT

　　TEXT

　　TEXT

　　D

　　—

　　—

　　—

　　8

　　是

　　是

　　否

　　是

　　针对特定健康问题的用药指导

　　针对特定健康问题的心理指导

　　其他非特定指导

　　格式 YYYYMMDD

　　表13　健康教育处方数据结构 (续)

　　字段名英文名类型长度必填备注

　　表14　健康教育处方管理接口响应

　　参数

　　响应结果

　　状态码

　　消息

　　英文参数

　　Response

　　Status

　　Message

　　数据类型

　　布尔值

　　整数

　　字符串

　　约束

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　—

　　定义

　　响应执行结果

　　响应状态码

　　—

　　5.3.2 数据查询接口

　　5.3.2.1 健康档案查询

　　5.3.2.1.1 接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作;数据需要即时

　　同步。

　　5.3.2.1.2 健康档案查询服务请求接口的参数和响应分别见表15 和表16。

　　表15　健康档案查询接口请求

　　参数

　　服务标识

　　方法

　　请求参数表

　　值

　　UserArchive

　　GET

　　证件类型

　　证件号

　　personcardType

　　personcardNo

　　表16　健康档案查询接口响应

　　参数

　　响应结果

　　状态码

　　响应类型

　　响应数据

　　英文参数

　　Response

　　Status

　　Content‑Type

　　Data

　　数据类型

　　布尔值

　　整数

　　字符串

　　字符串

　　约束

　　必要

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　application/json

　　—

　　定义

　　响应执行结果

　　响应状态码

　　参照RFC6838

　　JSON 格式结果

　　5.3.2.2 服务列表查询

　　5.3.2.2.1 接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作;数据需要即时同步;

　　6

　　DB32/T 5197—2025

　　5.3.2.2.2 服务列表查询服务的接口请求见表17，其中服务类型枚举值包括体检、随访、检验、检查、用药

　　处方、健康教育处方;接口响应见表18、表19。

　　表17　服务列表查询接口请求

　　参数

　　服务标识

　　方法

　　请求参数表

　　值

　　ListCheck

　　GET

　　证件类型

　　证件号

　　服务类型

　　开始日期

　　结束日期

　　personcardType

　　personcardNo

　　type

　　dateStart

　　dateEnd

　　表18　服务列表查询接口响应

　　参数

　　响应结果

　　状态码

　　响应类型

　　响应数据

　　英文参数

　　Response

　　Status

　　Content‑Type

　　Data

　　数据类型

　　布尔值

　　整数

　　字符串

　　字符串

　　约束

　　必要

　　必要

　　必要

　　可选

　　值域

　　1：成功/0：失败

　　—

　　application/json

　　—

　　定义

　　响应执行结果

　　响应状态码

　　参照RFC6838

　　JSON 格式结果

　　表19　服务列表查询接口响应数据参数

　　字段名

　　编号

　　机构

　　执行日期

　　英文名

　　EXEC_ID

　　INSTITUTION

　　PRESCRIPTION_DATE

　　类型

　　VC

　　VC

　　D

　　长度

　　12

　　100

　　8

　　必填

　　是

　　是

　　是

　　备注

　　服务执行识别号

　　医疗机构名称

　　日期格式YYYYMMDD

　　5.3.2.2.3 返回的随访的数据格式应按照DB32/T 4155.2—2021 的表4 和表5 进行编写;返回的体检、检

　　查、检验数据格式按照DB32/T 4155.6—2021 的表4 进行编写;返回的健康教育处方数据格式按照表13

　　进行编写。

　　5.4 返回类型

　　返回类型应在返回数据中标明，返回值中的字段标准参照附录A。

　　6 数据传输

　　6.1 消息实体结构

　　6.1.1 消息头

　　消息头的构成内容见表20。用户权限管理参照GB/T 31504 的要求进行设计与维护。

　　7

　　DB32/T 5197—2025

　　表20　消息头构成

　　成员

　　eventClass

　　eventId

　　eventVersion

　　msgId

　　createTime

　　organizationId

　　sendSystemId

　　authorityType

　　userIdentity

　　accessToken

　　accessLicense

　　sessionId

　　类型

　　String

　　String

　　String

　　Int

　　Datetime

　　Int

　　Int

　　Int

　　String

　　String

　　String

　　String

　　描述

　　事件类别，固定值： SYTP

　　事件编号，即需要传输的数据集编号，例如：DA01

　　事件版本，即数据集所在的交换规范本版号，例如0.1

　　消息的唯一标识

　　消息创建时间，格式为YYYYMMDDHHmmss

　　消息来源机构编号

　　消息来源系统

　　认证方式，2(access_token 认证)，3(license 认证)，9(ip 认证)

　　访问服务器使用的用户身份鉴别码

　　authorityType 为2 时必填，访问服务器使用的权限鉴别口令

　　authorityType 为3 时必填，周期性固定身份鉴权信息，统一颁发

　　用于存储唯一id 号(此id 要求每次传输前生成，保证不重复)

　　6.1.2 消息体

　　按照第5 章健康档案新建、健康档案更新、随访数据新建、随访数据更新、用药处方接收、健康教育处

　　方接收、健康档案查询、服务列表查询的要求，基于XML Schema 或者JSON 格式进行规范表示。

　　6.2 授权码获取服务

　　6.2.1 用户调用服务接口前，需要先获取身份认证令牌。

　　6.2.2 令牌接口地址设计为HTTP[S]：//URL_ADDR[：PORT]/API/AUTH/，用户使用GET 方法

　　通过身份验证信息交换服务器令牌。

　　6.2.3 令牌超时时间设置为24 h，在令牌超时或遇到异常后需通过接口重新获取令牌。

　　6.3 同步传输系统

　　6.3.1 传输协议

　　应具有网络数据通信能力，支持TCP/IP 协议的实时网络，提供稳定的网络通讯支持、网络物理和链

　　路支撑。应使用具有IPv4/IPv6 的双架构网络接口。

　　a) 对于非离线传输链路，如专线、互联网线路和VPN 等，应采用 TLS、IPSEC、SASL+SSL 等安

　　全传输协议，以保障传输链路的安全性，防止入侵攻击。

　　b) 在应用层，数据发送系统与数据接收系统采取SFTP 协议作为通信标准。数据接收系统方在本

　　地服务器架设SFTP 服务，以提供双方通信支持。

　　c) 支持顺序型断点续传功能。

　　d) 支持接收的文件的重命名及指定存储目录。

　　e) 应支持对接收文件的完整性校验。

　　f) 保障数据传输安全性，应将数据在传输过程中进行加密处理，宜采用国家密码局推荐的国密算

　　法加密。

　　8

　　DB32/T 5197—2025

　　6.3.2 数据存储

　　应确保数据流通过程中的数据存储满足合法性、合规性和安全性的相关要求。

　　a) 存储重要数据和个人信息等敏感网络数据，应采用加密、安全存储、访问控制、安全审计等安全

　　措施;应保证数据的机密性、完整性和可用性，防范未经授权的访问、使用、修改、泄露和破坏。

　　b) 存储健康医疗数据，应通过密码技术等方式实施完整性控制，确保数据的准确性和完整性，并为

　　其提供针对入侵、注入、非法修改的保护机制。

　　6.3.3 带宽与延迟

　　带宽速率不小于100 M/bs;网络延迟不大于100 ms。

　　6.3.4 网络冗余

　　对于应急事件防范，应配置备份节点以及备份数据库。

　　9

　　DB32/T 5197—2025

　　附录A

　　(资料性)

　　服务接口请求响应状态码

　　服务接口请求响应状态码见表A.1。

　　表A.1　服务接口请求响应状态码

　　编码

　　100

　　200

　　201

　　202

　　204

　　400

　　401

　　403

　　404

　　405

　　406

　　409

　　410

　　412

　　429

　　500

　　501

　　503

　　说明

　　Continue

　　OK

　　Created

　　Accepted

　　No Content

　　Bad Request

　　Unauthorized

　　Forbidden

　　Not Found

　　Method Not Allowed

　　Not Acceptable

　　Conflict

　　Gone

　　Precondition Failed

　　Too many requests

　　Internal Seryer Frror

　　Not Implemented

　　Service Unavailable