1、7,江苏省市场监督管理局 发 布中 国 标 准 出 版 社 出 版糖尿病健康医疗数据接口与数据传输要求Requirements for interface and data transmission of diabetes health medical data20250910 发布20251010 实施CCS L 79DB32/T 51972025ICS 33.040.40DB32/T 51972025前言 1 范围 12 规范性引用文件 13 术语和定义 14 缩略语 15 数据接口 26 数据传输 7附录 A（资料性）服务接口请求响应状态码 10目 次DB32/T 51972025前言
2、本文件按照 GB/T 1.12020标准化工作导则 第 1 部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由江苏省卫生健康委员会提出并组织实施。本文件由江苏省卫生健康标准化技术委员会归口。本文件起草单位：南京大学、江苏省疾病预防控制中心。本文件主要起草人：张峻峰、张文红、徐佳南、陈斯蕾、胡伟、徐金水、郭海建。DB32/T 51972025糖尿病健康医疗数据接口与数据传输要求1范围本文件规定了糖尿病健康医疗数据接口与数据传输的相关要求。本文件适用于区域糖尿病健康医疗数据的传输，其它慢性疾病的数据接口和传输可参照使用。2
3、规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 31504 信息安全技术 鉴别与授权 数字身份信息服务框架规范GB/T 38672 信息技术 大数据 接口基本要求DB32/T 4155.12021 全民健康信息平台共享数据集规范 第 1 部分：基本健康档案DB32/T 4155.22021 全民健康信息平台共享数据集规范 第 2 部分：慢病管理DB32/T 4155.62021 全民健康信息平台共享数据集规范 第 6 部分：医疗检验检查
4、DB32/T 4155.72021 全民健康信息平台共享数据集规范 第 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 格式，请求头宜采用 ContentType：application/js
5、on，并通过 POST/GET/PATCH 等方式访问。5.1.2通过统一的接口地址提供不同服务的接入，使用服务标识区分。5.1.3接口地址设计为 HTTPS：/URL_ADDR：PORT/API/SERVICE/。5.1.4接口符合 GB/T 38672 的技术要求。1DB32/T 519720255.2参数类型参数类型是所有允许取值的数据类型的表达，数据类型应符合表 1 的规定。表 1 请求参数数据类型数据类型字符串型整数型浮点数型布尔型日期型日期时间型表示方法stringintdoublebooldatedatetime备注使用符合 UTF8 编码的字符串32 位有符号整数使用双精度浮点
6、数存储小数使用 0 和 1 表示假值与真值YYYYMMDD 表示日期YYYYMMDDhhmmss 表示日期时间具体到 s5.3接口类型5.3.1数据管理接口5.3.1.1健康档案新建5.3.1.1.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案新建，支持批量操作，并获取操作结果；数据需要即时同步。5.3.1.1.2 健康档案新建服务的接口请求和接口响应分别见表 2 和表 3。表 2 健康档案新建接口请求参数服务标识方法数据类型请求体值UserArchivePOSTapplication/jsonArchiveData，格式按照 DB32/T 4155.12021
7、 的表 4 进行编写2DB32/T 51972025表 3 健康档案新建接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类型布尔值整数字符串约束必要必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.1.2健康档案更新5.3.1.2.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案更新，支持批量操作，并获取操作结果；数据需要即时同步。5.3.1.2.2 健康档案更新服务的接口请求和接口响应分别见表 4 和表 5。表 4 健康档案更新接口请求参数服务标识方法数据类型请求参数请求体值UserArchivePATCHapp
8、lication/json证件类型证件号ArchiveData，格式按照 DB32/T 4155.12021 的表 4 进行编写personcardTypepersoncardNo表 5 健康档案更新接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类型布尔值整数字符串约束必要必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.1.3随访数据新建5.3.1.3.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据新建，支持批量操作，并获取操作结果；数据需要即时同步。5.3.1.3.2随访数据新建服务的接口请求和接口响应分别
9、见表 6 和表 7。表 6 随访数据新建接口请求参数服务标识方法数据类型请求体值FollowUpArchivePOSTapplication/jsonArchiveData，格式按照 DB2/T 4155.22021 的表 4 和表 5 进行编写3DB32/T 51972025表 7 随访数据新建接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类型布尔值整数字符串约束必要必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.1.4随访数据更新5.3.1.4.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据更新，并获取操
10、作结果；数据需要即时同步。5.3.1.4.2随访数据更新服务的接口请求和接口响应分别见表 8 和表 9。表 8 随访数据更新接口参数参数服务标识方法数据类型请求参数请求体值FollowUpArchivePATCHapplication/json证件类型证件号医院代码随访时间ArchiveData，格式按照 DB32/T 4155.22021 的表 4 和表 5 进行编写personcardTypepersoncardNohospitalIdfollowUpDate表 9 随访数据更新接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类型布尔值整数字符串约束必要
11、必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.1.5用药处方接收5.3.1.5.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理用药处方，支持批量操作，并获取操作结果；数据需要即时同步。5.3.1.5.2用药处方接收服务的接口请求和接口响应分别见表 10 和表 11。表 10 用药处方接收的接口请求服务标识方法PrescriptionPOST参数值4DB32/T 51972025数据类型请求体application/jsonPrescriptionData，数据结构按照 DB 32/T 4155.72021 中表 10 及表 11 进行填写表 10 用药
12、处方接收的接口请求（续）参数值表 11 用药处方接收接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类型布尔值整数字符串约束必要必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.1.6健康教育处方接收5.3.1.6.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康教育处方，支持批量操作，并获取操作结果；数据需要即时同步。5.3.1.6.2健康教育处方接收服务的接口请求见表 12，接口请求体的具体数据结构请见表 13，接口响应见表 14。表 12 健康教育处方接收接口请求参数服务标识方法数据类型请求体值CaringPOS
13、Tapplication/jsonCaringData表 13 健康教育处方数据结构患者证件号门诊 ID疾病名机构科室医生证件号开单时间营养建议运动建议PAT_IDOUTPAT_IDDISEASE_NAMEINSTITUTIONDEPARTMENTDOCTOR_IDPRESCRIPTION_DATETIMENUTRITION_PRESCRIPTIONEXERCISE_PRESCRIPTIONVCVCVCVCVCVCDTTEXTTEXT1812100100501814是是是是是是是是是身份证号格式，必须唯一门诊识别号疾病名称医疗机构名称科室名称医生的身份证号日期时间格式 YYYYMMDDhhmm
14、ss针对特定健康问题的建议或指导针对特定健康问题的运动建议字段名英文名类型长度必填备注5DB32/T 51972025用药指导心理指导其它指导下次就诊时间MEDICINE_PRESCRIPTIONMENTAL_PRESCRIPTIONOTHER_PRESCRIPTIONNEXT_VISIT_DATETEXTTEXTTEXTD8是是否是针对特定健康问题的用药指导针对特定健康问题的心理指导其他非特定指导格式 YYYYMMDD表 13 健康教育处方数据结构（续）字段名英文名类型长度必填备注表 14 健康教育处方管理接口响应参数响应结果状态码消息英文参数ResponseStatusMessage数据类
15、型布尔值整数字符串约束必要必要可选值域1：成功/0：失败定义响应执行结果响应状态码5.3.2数据查询接口5.3.2.1健康档案查询5.3.2.1.1接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作；数据需要即时同步。5.3.2.1.2健康档案查询服务请求接口的参数和响应分别见表 15 和表 16。表 15 健康档案查询接口请求参数服务标识方法请求参数表值UserArchiveGET证件类型证件号personcardTypepersoncardNo表 16 健康档案查询接口响应参数响应结果状态码响应类型响应数据英文参数ResponseStatusContentTypeData
16、数据类型布尔值整数字符串字符串约束必要必要必要可选值域1：成功/0：失败application/json定义响应执行结果响应状态码参照 RFC6838JSON 格式结果5.3.2.2服务列表查询5.3.2.2.1接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作；数据需要即时同步；6DB32/T 519720255.3.2.2.2服务列表查询服务的接口请求见表 17，其中服务类型枚举值包括体检、随访、检验、检查、用药处方、健康教育处方；接口响应见表 18、表 19。表 17 服务列表查询接口请求参数服务标识方法请求参数表值ListCheckGET证件类型证件号服务类型开始日期
17、结束日期personcardTypepersoncardNotypedateStartdateEnd表 18 服务列表查询接口响应参数响应结果状态码响应类型响应数据英文参数ResponseStatusContentTypeData数据类型布尔值整数字符串字符串约束必要必要必要可选值域1：成功/0：失败application/json定义响应执行结果响应状态码参照 RFC6838JSON 格式结果表 19 服务列表查询接口响应数据参数字段名编号机构执行日期英文名EXEC_IDINSTITUTIONPRESCRIPTION_DATE类型VCVCD长度121008必填是是是备注服务执行识别号医疗机构
18、名称日期格式 YYYYMMDD5.3.2.2.3返回的随访的数据格式应按照 DB32/T 4155.22021 的表 4 和表 5 进行编写；返回的体检、检查、检验数据格式按照 DB32/T 4155.62021 的表 4 进行编写；返回的健康教育处方数据格式按照表 13进行编写。5.4返回类型返回类型应在返回数据中标明，返回值中的字段标准参照附录 A。6数据传输6.1消息实体结构6.1.1消息头消息头的构成内容见表 20。用户权限管理参照 GB/T 31504 的要求进行设计与维护。7DB32/T 51972025表 20 消息头构成成员eventClasseventIdeventVersi
19、onmsgIdcreateTimeorganizationIdsendSystemIdauthorityTypeuserIdentityaccessTokenaccessLicensesessionId类型StringStringStringIntDatetimeIntIntIntStringStringStringString描述事件类别，固定值：SYTP事件编号，即需要传输的数据集编号，例如：DA01事件版本，即数据集所在的交换规范本版号，例如 0.1消息的唯一标识消息创建时间，格式为 YYYYMMDDHHmmss消息来源机构编号消息来源系统认证方式，2（access_token 认证），
20、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 令牌接口地址
21、设计为 HTTPS：/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）在应用层，数据发送系统与数据接收系统采
22、取 SFTP 协议作为通信标准。数据接收系统方在本地服务器架设 SFTP 服务，以提供双方通信支持。c）支持顺序型断点续传功能。d）支持接收的文件的重命名及指定存储目录。e）应支持对接收文件的完整性校验。f）保障数据传输安全性，应将数据在传输过程中进行加密处理，宜采用国家密码局推荐的国密算法加密。8DB32/T 519720256.3.2数据存储应确保数据流通过程中的数据存储满足合法性、合规性和安全性的相关要求。a）存储重要数据和个人信息等敏感网络数据，应采用加密、安全存储、访问控制、安全审计等安全措施；应保证数据的机密性、完整性和可用性，防范未经授权的访问、使用、修改、泄露和破坏。b）存储健
23、康医疗数据，应通过密码技术等方式实施完整性控制，确保数据的准确性和完整性，并为其提供针对入侵、注入、非法修改的保护机制。6.3.3带宽与延迟带宽速率不小于 100 M/bs；网络延迟不大于 100 ms。6.3.4网络冗余对于应急事件防范，应配置备份节点以及备份数据库。9DB32/T 51972025附录A（资料性）服务接口请求响应状态码服务接口请求响应状态码见表 A.1。表 A.1 服务接口请求响应状态码编码100200201202204400401403404405406409410412429500501503说明ContinueOKCreatedAcceptedNo ContentBad RequestUnauthorizedForbiddenNot FoundMethod Not AllowedNot AcceptableConflictGonePrecondition FailedToo many requestsInternal Seryer FrrorNot ImplementedService Unavailable10
