! 7 ,     江苏省市场监督管理局 　　发 布 中 国 标 准 出 版 社 　　出 版糖尿病健康医疗数据接口与数据 传输要求 Requirements for interface and data transmission of diabetes health medical data 2025 ‑09‑10 发布 2025 ‑10‑10 实施CCS L 79 DB32/T 5197 —2025ICS 33.040.40DB32/T 5197 —2025 前言…………………………………………………………………………………………………………… Ⅲ 1 范围………………………………………………………………………………………………………… 1 2 规范性引用文件 …………………………………………………………………………………………… 1 3 术语和定义 ………………………………………………………………………………………………… 1 4 缩略语……………………………………………………………………………………………………… 1 5 数据接口 …………………………………………………………………………………………………… 2 6 数据传输 …………………………………………………………………………………………………… 7 附录 A（资料性） 服务接口请求响应状态码 ……………………………………………………………… 10目 次 ⅠDB32/T 5197 —2025 前 言 本文件按照 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的技术要求 。 1DB32/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进行编写 2DB32/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进行编写 3DB32/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参数 值 4DB32/T 5197 —2025 数据类型 请求体application/json PrescriptionData ，数据结构按照 DB 32/T 4155 .7—2021中表 10及表 11进行填写表10　用药处方接收的接口请求 （续） 参数 值 表11