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

CCSL79江苏省地方标准DB32/T5197—2025糖尿病健康医疗数据接口与数据传输要求Requirementsforinterfaceanddatatransmissionofdiabeteshealthmedicaldata2025-09-10发布2025-10-10实施江苏省市场监督管理局发布Ⅰ前言 Ⅲ 2规范性引用文件 3术语和定义 4缩略语 5数据接口 6数据传输 附录A（资料性）服务接口请求响应状态码 Ⅲ本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由江苏省卫生健康委员会提出并组织实施。本文件由江苏省卫生健康标准化技术委员会归口。本文件起草单位：南京大学、江苏省疾病预防控制中心。DB32/T5197—20251糖尿病健康医疗数据接口与数据传输要求本文件规定了糖尿病健康医疗数据接口与数据传输的相关要求。本文件适用于区域糖尿病健康医疗数据的传输，其它慢性疾病的数据接口和传输可参照使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T31504信息安全技术鉴别与授权数字身份信息服务框架规范GB/T38672信息技术大数据接口基本要求DB32/T4155.1—2021全民健康信息平台共享数据集规范第1部分：基本健康档案DB32/T4155.2—2021全民健康信息平台共享数据集规范第2部分：慢病管理DB32/T4155.6—2021全民健康信息平台共享数据集规范第6部分：医疗检验检查DB32/T4155.7—2021全民健康信息平台共享数据集规范第7部分：医疗门诊3术语和定义本文件没有需要界定的术语和定义。4缩略语下列缩略语适用于本文件。URL：统一资源定位符（UniformResourceLocator）XML：可扩展标记语言（ExtensibleMarkupLanguage）5数据接口5.1接口方式5.1.1接口采用IETFRFC2616的HTTP协议进行传输，数据交换格式宜为JSON格式，请求头宜采用Content-Type：application/json，并通过POST/GET/PATCH等方式访问。5.1.2通过统一的接口地址提供不同服务的接入，使用服务标识区分。5.1.3接口地址设计为HTTP［S//URL_ADDRPORT］/API/SERVICE/。5.1.4接口符合GB/T38672的技术要求。2DB32/T5197—20255.2参数类型参数类型是所有允许取值的数据类型的表达，数据类型应符合表1的规定。表1请求参数数据类型数据类型表示方法备注字符串型string使用符合UTF-8编码的字符串整数型int32位有符号整数浮点数型double使用双精度浮点数存储小数布尔型bool使用0和1表示假值与真值日期型YYYYMMDD表示日期日期时间型datetimeYYYYMMDDhhmmss表示日期时间具体到s5.3接口类型5.3.1数据管理接口健康档案新建.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案新建，支持批量操作，并获取操作结果；数据需要即时同步。.2健康档案新建服务的接口请求和接口响应分别见表2和表3。表2健康档案新建接口请求参数值服务标识UserArchive方法POST数据类型application/json请求体ArchiveData，格式按照DB32/T4155.1—2021的表4进行编写DB32/T5197—20253表3健康档案新建接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——健康档案更新.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康档案更新，支持批量操作，并获取操作结果；数据需要即时同步。.2健康档案更新服务的接口请求和接口响应分别见表4和表5。表4健康档案更新接口请求参数值服务标识UserArchive方法PATCH数据类型application/json请求参数证件类型personcardType证件号personcardNo请求体ArchiveData，格式按照DB32/T4155.1—2021的表4进行编写表5健康档案更新接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——随访数据新建.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据新建，支持批量操作，并获取操作结果；数据需要即时同步。.2随访数据新建服务的接口请求和接口响应分别见表6和表7。表6随访数据新建接口请求参数值服务标识FollowUpArchive方法POST数据类型application/json请求体ArchiveData，格式按照DB2/T4155.2—2021的表4和表5进行编写DB32/T5197—20254表7随访数据新建接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——随访数据更新.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理随访数据更新，并获取操作结果；数据需要即时同步。.2随访数据更新服务的接口请求和接口响应分别见表8和表9。表8随访数据更新接口参数参数值服务标识FollowUpArchive方法PATCH数据类型application/json请求参数证件类型personcardType证件号personcardNo医院代码hospitalId随访时间followUpDate请求体ArchiveData，格式按照DB32/T4155.2—2021的表4和表5进行编写表9随访数据更新接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——用药处方接收.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理用药处方，支持批量操作，并获取操作结果；数据需要即时同步。.2用药处方接收服务的接口请求和接口响应分别见表10和表11。表10用药处方接收的接口请求参数值服务标识Prescription方法POSTDB32/T5197—20255表10用药处方接收的接口请求（续）参数值数据类型application/json请求体PrescriptionData，数据结构按照DB32/T4155.7—2021中表10及表11进行填写表11用药处方接收接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——健康教育处方接收.1接口实现的主要功能是服务发起方向服务提供方请求数据上传，用于动态管理健康教育处方，支持批量操作，并获取操作结果；数据需要即时同步。.2健康教育处方接收服务的接口请求见表12，接口请求体的具体数据结构请见表13，接口响应表12健康教育处方接收接口请求参数值服务标识Caring方法POST数据类型application/json请求体CaringData表13健康教育处方数据结构字段名英文名类型长度必填备注患者证件号PAT_IDVC是身份证号格式，必须唯一门诊IDOUTPAT_IDVC是门诊识别号疾病名DISEASE_NAMEVC是疾病名称机构INSTITUTIONVC是医疗机构名称科室DEPARTMENTVC是科室名称医生证件号DOCTOR_IDVC是医生的身份证号开单时间PRESCRIPTION_DATETIMEDT是日期时间格式YYYYMMDDhhmmss营养建议NUTRITION_PRESCRIPTIONTEXT—是针对特定健康问题的建议或指导运动建议EXERCISE_PRESCRIPTIONTEXT—是针对特定健康问题的运动建议DB32/T5197—20256表13健康教育处方数据结构（续）字段名英文名类型长度必填备注用药指导MEDICINE_PRESCRIPTIONTEXT—是针对特定健康问题的用药指导心理指导MENTAL_PRESCRIPTIONTEXT—是针对特定健康问题的心理指导其它指导OTHER_PRESCRIPTIONTEXT—否其他非特定指导下次就诊时间NEXT_VISIT_DATED8是格式YYYYMMDD表14健康教育处方管理接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码消息字符串可选——5.3.2数据查询接口健康档案查询.1接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作；数据需要即时同步。.2健康档案查询服务请求接口的参数和响应分别见表15和表16。表15健康档案查询接口请求参数值服务标识UserArchive方法GET请求参数表证件类型personcardType证件号personcardNo表16健康档案查询接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码响应类型Content-Type字符串必要application/json参照RFC6838响应数据Data字符串可选—JSON格式结果服务列表查询.1接口实现的主要功能是服务发起方向服务提供方请求数据检索，支持批量操作；数据需要即时同步；DB32/T5197—2025.2服务列表查询服务的接口请求见表17，其中服务类型枚举值包括体检、随访、检验、检查、用药表17服务列表查询接口请求参数值服务标识ListCheck方法GET请求参数表证件类型personcardType证件号personcardNo服务类型type开始日期dateStart结束日期dateEnd表18服务列表查询接口响应参数英文参数数据类型约束值域定义响应结果布尔值必要响应执行结果状态码Status整数必要—响应状态码响应类型Content-Type字符串必要application/json参照RFC6838响应数据Data字符串可选—JSON格式结果表19服务列表查询接口响应数据参数字段名英文名类型长度必填备注编号EXEC_IDVC是服务执行识别号机构INSTITUTIONVC是医疗机构名称执行日期PRESCRIPTION_DATED8是日期格式YYYYMMDD.3返回的随访的数据格式应按照DB32/T4155.2—2021的表4和表5进行编写；返回的体检、检查、检验数据格式按照DB32/T4155.6—2021的表4进行编写；返回的健康教育处方数据格式按照表13进行编写。5.4返回类型返回类型应在返回数据中标明，返回值中的字段标准参照附录A。6数据传输6.1消息实体结构6.1.1消息头消息头的构成内容见表20。用户权限管理参照GB/T31504的要求进行设计与维护。DB32/T5197—20258表20消息头构成成员类型描述eventClassString事件类别，固定值：SYTPeventIdString事件编号，即需要传输的数据集编号，例如：DA01eventVersionString事件版本，即数据集所在的交换规范本版号，例如0.1msgIdInt消息的唯一标识createTimeDatetime消息创建时间，格式为YYYYMMDDHHmmssorganizationIdInt消息来源机构编号sendSystemIdInt消息来源系统authorityTypeIntuserIdentityString访问服务器使用的用户身份鉴别码StringauthorityType为2时必填，访问服务器使用的权限鉴别口令StringauthorityType为3时必填，周期性固定身份鉴权信息，统一颁发String用于存储唯一id号（此id要求每次传输前生成，保证不重复）6.1.2消息体按照第5章健康档案新建、健康档案更新、随访数据新建、随访数据更新、用药处方接收、健康教育处方接收、健康档案查询、服务列表查询的要求，基于XMLSchema或者JSON格式进行规范表示。6.2授权码获取服务6.2.1用户调用服务接口前，需要先获取身份认证令牌。6.2.2令牌接口地址设计为HTTP［S//URL_ADDRPORT］/API/AUTH/，用户使用GET方法通过身份验证信息交换服务器令牌。6.2.3令牌超时时间设置为24h，在令牌超时或遇到异常后需通过接口重新获取令牌。6.3同步传输系统6.3.1传输协议应具有网络数据通信能力，支持TCP/IP协议的实时网络，提供稳定的网络通讯支持、网络物理和链路支撑。应使用具