ICS33.040.40

CCSL79

!7,



DB32/T5197—2025

糖尿病健康醫(yī)療數(shù)據(jù)接口與數(shù)據(jù)

傳輸要求

Requirementsforinterfaceanddatatransmissionofdiabetes

healthmedicaldata

2025?09?10發(fā)布2025?10?10實施

江蘇省市場監(jiān)督管理局發(fā)布

中國標(biāo)準(zhǔn)出版社出版

DB32/T5197—2025

目次

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

1范圍…………………………1

2規(guī)范性引用文件……………1

3術(shù)語和定義…………………1

4縮略語………………………1

5數(shù)據(jù)接口……………………2

6數(shù)據(jù)傳輸……………………7

附錄A（資料性）服務(wù)接口請求響應(yīng)狀態(tài)碼………………10

Ⅰ

DB32/T5197—2025

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由江蘇省衛(wèi)生健康委員會提出并組織實施。

本文件由江蘇省衛(wèi)生健康標(biāo)準(zhǔn)化技術(shù)委員會歸口。

本文件起草單位：南京大學(xué)、江蘇省疾病預(yù)防控制中心。

本文件主要起草人：張峻峰、張文紅、徐佳南、陳斯蕾、胡偉、徐金水、郭海建。

Ⅲ

DB32/T5197—2025

糖尿病健康醫(yī)療數(shù)據(jù)接口與數(shù)據(jù)

傳輸要求

1范圍

本文件規(guī)定了糖尿病健康醫(yī)療數(shù)據(jù)接口與數(shù)據(jù)傳輸?shù)南嚓P(guān)要求。

本文件適用于區(qū)域糖尿病健康醫(yī)療數(shù)據(jù)的傳輸，其它慢性疾病的數(shù)據(jù)接口和傳輸可參照使用。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文

件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T31504信息安全技術(shù)鑒別與授權(quán)數(shù)字身份信息服務(wù)框架規(guī)范

GB/T38672信息技術(shù)大數(shù)據(jù)接口基本要求

DB32/T4155.1—2021全民健康信息平臺共享數(shù)據(jù)集規(guī)范第1部分：基本健康檔案

DB32/T4155.2—2021全民健康信息平臺共享數(shù)據(jù)集規(guī)范第2部分：慢病管理

DB32/T4155.6—2021全民健康信息平臺共享數(shù)據(jù)集規(guī)范第6部分：醫(yī)療檢驗檢查

DB32/T4155.7—2021全民健康信息平臺共享數(shù)據(jù)集規(guī)范第7部分：醫(yī)療門診

3術(shù)語和定義

本文件沒有需要界定的術(shù)語和定義。

4縮略語

下列縮略語適用于本文件。

JSON：JS對象標(biāo)記（JavaScriptObjectNotation）

URL：統(tǒng)一資源定位符（UniformResourceLocator）

XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）

5數(shù)據(jù)接口

5.1接口方式

5.1.1接口采用IETFRFC2616的HTTP協(xié)議進(jìn)行傳輸，數(shù)據(jù)交換格式宜為JSON格式，請求頭宜采

用Content?Type：application/json，并通過POST/GET/PATCH等方式訪問。

5.1.2通過統(tǒng)一的接口地址提供不同服務(wù)的接入，使用服務(wù)標(biāo)識區(qū)分。

5.1.3接口地址設(shè)計為HTTP［S］：//URL_ADDR［：PORT］/API/SERVICE/。

5.1.4接口符合GB/T38672的技術(shù)要求。

1

DB32/T5197—2025

5.2參數(shù)類型

參數(shù)類型是所有允許取值的數(shù)據(jù)類型的表達(dá)，數(shù)據(jù)類型應(yīng)符合表1的規(guī)定。

表1請求參數(shù)數(shù)據(jù)類型

數(shù)據(jù)類型表示方法備注

字符串型string使用符合UTF?8編碼的字符串

整數(shù)型int32位有符號整數(shù)

浮點數(shù)型double使用雙精度浮點數(shù)存儲小數(shù)

布爾型bool使用0和1表示假值與真值

日期型dateYYYYMMDD表示日期

日期時間型datetimeYYYYMMDDhhmmss表示日期時間具體到s

5.3接口類型

5.3.1數(shù)據(jù)管理接口

健康檔案新建

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理健康檔案新建，

支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2健康檔案新建服務(wù)的接口請求和接口響應(yīng)分別見表2和表3。

表2健康檔案新建接口請求

參數(shù)值

服務(wù)標(biāo)識UserArchive

方法POST

數(shù)據(jù)類型application/json

請求體ArchiveData，格式按照DB32/T4155.1—2021的表4進(jìn)行編寫

2

DB32/T5197—2025

表3健康檔案新建接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

健康檔案更新

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理健康檔案更新，

支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2健康檔案更新服務(wù)的接口請求和接口響應(yīng)分別見表4和表5。

表4健康檔案更新接口請求

參數(shù)值

服務(wù)標(biāo)識UserArchive

方法PATCH

數(shù)據(jù)類型application/json

證件類型personcardType

請求參數(shù)

證件號personcardNo

請求體ArchiveData，格式按照DB32/T4155.1—2021的表4進(jìn)行編寫

表5健康檔案更新接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

隨訪數(shù)據(jù)新建

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理隨訪數(shù)據(jù)新建，

支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2隨訪數(shù)據(jù)新建服務(wù)的接口請求和接口響應(yīng)分別見表6和表7。

表6隨訪數(shù)據(jù)新建接口請求

參數(shù)值

服務(wù)標(biāo)識FollowUpArchive

方法POST

數(shù)據(jù)類型application/json

請求體ArchiveData，格式按照DB2/T4155.2—2021的表4和表5進(jìn)行編寫

3

DB32/T5197—2025

表7隨訪數(shù)據(jù)新建接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

隨訪數(shù)據(jù)更新

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理隨訪數(shù)據(jù)更新，

并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2隨訪數(shù)據(jù)更新服務(wù)的接口請求和接口響應(yīng)分別見表8和表9。

表8隨訪數(shù)據(jù)更新接口參數(shù)

參數(shù)值

服務(wù)標(biāo)識FollowUpArchive

方法PATCH

數(shù)據(jù)類型application/json

證件類型personcardType

證件號personcardNo

請求參數(shù)

醫(yī)院代碼hospitalId

隨訪時間followUpDate

請求體ArchiveData，格式按照DB32/T4155.2—2021的表4和表5進(jìn)行編寫

表9隨訪數(shù)據(jù)更新接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

用藥處方接收

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理用藥處方，支持

批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2用藥處方接收服務(wù)的接口請求和接口響應(yīng)分別見表10和表11。

表10用藥處方接收的接口請求

參數(shù)值

服務(wù)標(biāo)識Prescription

方法POST

4

DB32/T5197—2025

表10用藥處方接收的接口請求（續(xù)）

參數(shù)值

數(shù)據(jù)類型application/json

請求體PrescriptionData，數(shù)據(jù)結(jié)構(gòu)按照DB32/T4155.7—2021中表10及表11進(jìn)行填寫

表11用藥處方接收接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

健康教育處方接收

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理健康教育處方，

支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。

.2健康教育處方接收服務(wù)的接口請求見表12，接口請求體的具體數(shù)據(jù)結(jié)構(gòu)請見表13，接口響應(yīng)

見表14。

表12健康教育處方接收接口請求

參數(shù)值

服務(wù)標(biāo)識Caring

方法POST

數(shù)據(jù)類型application/json

請求體CaringData

表13健康教育處方數(shù)據(jù)結(jié)構(gòu)

字段名英文名類型長度必填備注

患者證件號PAT_IDVC18是身份證號格式，必須唯一

門診IDOUTPAT_IDVC12是門診識別號

疾病名DISEASE_NAMEVC100是疾病名稱

機(jī)構(gòu)INSTITUTIONVC100是醫(yī)療機(jī)構(gòu)名稱

科室DEPARTMENTVC50是科室名稱

醫(yī)生證件號DOCTOR_IDVC18是醫(yī)生的身份證號

開單時間PRESCRIPTION_DATETIMEDT14是日期時間格式Y(jié)YYYMMDDhhmmss

營養(yǎng)建議NUTRITION_PRESCRIPTIONTEXT—是針對特定健康問題的建議或指導(dǎo)

運動建議EXERCISE_PRESCRIPTIONTEXT—是針對特定健康問題的運動建議

5

DB32/T5197—2025

表13健康教育處方數(shù)據(jù)結(jié)構(gòu)（續(xù)）

字段名英文名類型長度必填備注

用藥指導(dǎo)MEDICINE_PRESCRIPTIONTEXT—是針對特定健康問題的用藥指導(dǎo)

心理指導(dǎo)MENTAL_PRESCRIPTIONTEXT—是針對特定健康問題的心理指導(dǎo)

其它指導(dǎo)OTHER_PRESCRIPTIONTEXT—否其他非特定指導(dǎo)

下次就診時間NEXT_VISIT_DATED8是格式Y(jié)YYYMMDD

表14健康教育處方管理接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

消息Message字符串可選——

5.3.2數(shù)據(jù)查詢接口

健康檔案查詢

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)檢索，支持批量操作；數(shù)據(jù)需要即時

同步。

.2健康檔案查詢服務(wù)請求接口的參數(shù)和響應(yīng)分別見表15和表16。

表15健康檔案查詢接口請求

參數(shù)值

服務(wù)標(biāo)識UserArchive

方法GET

證件類型personcardType

請求參數(shù)表

證件號personcardNo

表16健康檔案查詢接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

響應(yīng)類型Content?Type字符串必要application/json參照RFC6838

響應(yīng)數(shù)據(jù)Data字符串可選—JSON格式結(jié)果

服務(wù)列表查詢

.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)檢索，支持批量操作；數(shù)據(jù)需要即時同步；

6

DB32/T5197—2025

.2服務(wù)列表查詢服務(wù)的接口請求見表17，其中服務(wù)類型枚舉值包括體檢、隨訪、檢驗、檢查、用藥

處方、健康教育處方；接口響應(yīng)見表18、表19。

表17服務(wù)列表查詢接口請求

參數(shù)值

服務(wù)標(biāo)識ListCheck

方法GET

證件類型personcardType

證件號personcardNo

請求參數(shù)表服務(wù)類型type

開始日期dateStart

結(jié)束日期dateEnd

表18服務(wù)列表查詢接口響應(yīng)

參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義

響應(yīng)結(jié)果Response布爾值必要1：成功/0：失敗響應(yīng)執(zhí)行結(jié)果

狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼

響應(yīng)類型Content?Type字符串必要application/json參照RFC6838

響應(yīng)數(shù)據(jù)Data字符串可選—JSON格式結(jié)果

表19服務(wù)列表查詢接口響應(yīng)數(shù)據(jù)參數(shù)

字段名英文名類型長度必填備注

編號EXEC_IDVC12是服務(wù)執(zhí)行識別號

機(jī)構(gòu)INSTITUTIONVC100是醫(yī)療機(jī)構(gòu)名稱

執(zhí)行日期PRESCRIPTION_DATED8是日期格式Y(jié)YYYMMDD

.3返回的隨訪的數(shù)據(jù)格式應(yīng)按照DB32/T4155.2—2021的表4和表5進(jìn)行編寫；返回的體檢、檢

查、檢驗數(shù)據(jù)格式按照DB32/T4155.6—2021的表4進(jìn)行編寫；返回的健康教育處方數(shù)據(jù)格式按照表13

進(jìn)行編寫。

5.4返回類型

返回類型應(yīng)在返回數(shù)據(jù)中標(biāo)明，返回值中的字段標(biāo)準(zhǔn)參照附錄A。

6數(shù)據(jù)傳輸

6.1消息實體結(jié)構(gòu)

6.1.1消息頭

消息頭的構(gòu)成內(nèi)容見表20。用戶權(quán)限管理參照GB/T31504的要求進(jìn)行設(shè)計與維護(hù)。

7

DB32/T5197—2025

表20消息頭構(gòu)成

成員類型描述

eventClassString事件類別，固定值：SYTP

eventIdString事件編號，即需要傳輸?shù)臄?shù)據(jù)集編號，例如：DA01

eventVersionString事件版本，即數(shù)據(jù)集所在的交換規(guī)范本版號，例如0.1

msgIdInt消息的唯一標(biāo)識

createTimeDatetime消息創(chuàng)建時間，格式為YYYYMMDDHHmmss

organizationIdInt消息來源機(jī)構(gòu)編號

sendSystemIdInt消息來源系統(tǒng)

authorityTypeInt認(rèn)證方式，2（access_token認(rèn)證），3（license認(rèn)證），9（ip認(rèn)證）

userIdentityString訪問服務(wù)器使用的用戶身份鑒別碼

accessTokenStringauthorityType為2時必填，訪問服務(wù)器使用的權(quán)限鑒別口令

accessLicenseStringauthorityType為3時必填，周期性固定身份鑒權(quán)信息，統(tǒng)一頒發(fā)

sessionIdString用于存儲唯一id號（此id要求每次傳輸前生成，保證不重復(fù)）

6.1.2消息體

按照第5章健康檔案新建、健康檔案更新、隨訪數(shù)據(jù)新建、隨訪數(shù)據(jù)更新、用藥處方接收、健康教育處

方接收、健康檔案查詢、服務(wù)列表查詢的要求，基于XMLSchema或者JSON格式進(jìn)行規(guī)范表示。

6.2授權(quán)碼獲取服務(wù)

6.2.1用戶調(diào)用服務(wù)接口前，需要先獲取身份認(rèn)證令牌。

6.2.2令牌接口地址設(shè)計為HTTP［S］：//URL_ADDR［：PORT］/API/AUTH/，用戶使用GET方法

通過身份驗證信息交換服務(wù)器令牌。

6.2.3令牌超時時間設(shè)置為24h，在令牌超時或遇到異常后需通過接口重新獲取令牌。

6.3同步傳輸系統(tǒng)

6.3.1傳輸協(xié)議

應(yīng)具有網(wǎng)絡(luò)數(shù)據(jù)通信能力，支持TCP/IP協(xié)議的實時網(wǎng)絡(luò)，提供穩(wěn)定的網(wǎng)絡(luò)通訊支持、網(wǎng)絡(luò)物理和鏈

路支撐。應(yīng)使用具有IPv4/IPv6的雙架構(gòu)網(wǎng)絡(luò)接口。

a）對于非離線傳輸鏈路，如專線、互聯(lián)網(wǎng)線路和VPN等，應(yīng)采用TLS、IPSEC、SASL+SSL等安

全傳輸協(xié)議，以保障傳輸鏈路的安全性，防止入侵攻擊。

b）在應(yīng)用層，數(shù)據(jù)發(fā)送系統(tǒng)與數(shù)據(jù)接收系統(tǒng)采取SFTP協(xié)議作為通信標(biāo)準(zhǔn)。數(shù)據(jù)接收系統(tǒng)方在本

地服務(wù)器架設(shè)SFTP服務(wù)，以提供雙方通信支持。

c）支持順序型斷點續(xù)傳功能。

d）支持接收的文件的重命名及指定存儲目錄。

e）應(yīng)支持對接收文件的完整性校驗。

f）保障數(shù)據(jù)傳輸安全性，應(yīng)將數(shù)據(jù)在傳輸過程中進(jìn)行加密處理，宜采用國家密碼局推薦的國密算

法加密。

8

DB32/T5197—2025

6.3.2數(shù)據(jù)存儲

應(yīng)確保數(shù)據(jù)流通過程中的數(shù)據(jù)存儲滿足合法性、合規(guī)性和安全性的相關(guān)要求。

a）存儲重要數(shù)據(jù)和個人信息等敏感網(wǎng)絡(luò)數(shù)據(jù)，應(yīng)采用加密、安全存儲、訪問控制、安全審計等安全

措施；應(yīng)保證數(shù)據(jù)的機(jī)密性、完整性和可用性，防范未經(jīng)授權(quán)的訪問、使用、修改、泄露和破壞。

b）存儲健康醫(yī)療數(shù)據(jù)，應(yīng)通過密碼技術(shù)等方式實施完整性控制，確保數(shù)據(jù)的準(zhǔn)確性和完整性，并為

其提供針對入侵、注入、非法修改的保護(hù)機(jī)制。

6.3.3帶寬與延遲

帶寬速率不小于100M/bs；網(wǎng)絡(luò)延遲不大于100ms。

6.3.4網(wǎng)絡(luò)冗余

對于應(yīng)急事件防范，應(yīng)配置備份節(jié)點以及備份數(shù)據(jù)