CCSL79江蘇省地方標準DB32/T5197—2025糖尿病健康醫(yī)療數(shù)據(jù)接口與數(shù)據(jù)傳輸要求Requirementsforinterfaceanddatatransmissionofdiabeteshealthmedicaldata2025-09-10發(fā)布2025-10-10實施江蘇省市場監(jiān)督管理局發(fā)布Ⅰ前言 Ⅲ 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5數(shù)據(jù)接口 6數(shù)據(jù)傳輸 附錄A（資料性）服務(wù)接口請求響應(yīng)狀態(tài)碼 Ⅲ本文件按照GB/T1.1—2020《標準化工作導(dǎo)則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由江蘇省衛(wèi)生健康委員會提出并組織實施。本文件由江蘇省衛(wèi)生健康標準化技術(shù)委員會歸口。本文件起草單位：南京大學(xué)、江蘇省疾病預(yù)防控制中心。DB32/T5197—20251糖尿病健康醫(yī)療數(shù)據(jù)接口與數(shù)據(jù)傳輸要求本文件規(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縮略語下列縮略語適用于本文件。URL：統(tǒng)一資源定位符（UniformResourceLocator）XML：可擴展標記語言（ExtensibleMarkupLanguage）5數(shù)據(jù)接口5.1接口方式5.1.1接口采用IETFRFC2616的HTTP協(xié)議進行傳輸，數(shù)據(jù)交換格式宜為JSON格式，請求頭宜采用Content-Type：application/json，并通過POST/GET/PATCH等方式訪問。5.1.2通過統(tǒng)一的接口地址提供不同服務(wù)的接入，使用服務(wù)標識區(qū)分。5.1.3接口地址設(shè)計為HTTP［S//URL_ADDRPORT］/API/SERVICE/。5.1.4接口符合GB/T38672的技術(shù)要求。2DB32/T5197—20255.2參數(shù)類型參數(shù)類型是所有允許取值的數(shù)據(jù)類型的表達，數(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表示假值與真值日期型YYYYMMDD表示日期日期時間型datetimeYYYYMMDDhhmmss表示日期時間具體到s5.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ù)標識UserArchive方法POST數(shù)據(jù)類型application/json請求體ArchiveData，格式按照DB32/T4155.1—2021的表4進行編寫DB32/T5197—20253表3健康檔案新建接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——健康檔案更新.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理健康檔案更新，支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。.2健康檔案更新服務(wù)的接口請求和接口響應(yīng)分別見表4和表5。表4健康檔案更新接口請求參數(shù)值服務(wù)標識UserArchive方法PATCH數(shù)據(jù)類型application/json請求參數(shù)證件類型personcardType證件號personcardNo請求體ArchiveData，格式按照DB32/T4155.1—2021的表4進行編寫表5健康檔案更新接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——隨訪數(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ù)標識FollowUpArchive方法POST數(shù)據(jù)類型application/json請求體ArchiveData，格式按照DB2/T4155.2—2021的表4和表5進行編寫DB32/T5197—20254表7隨訪數(shù)據(jù)新建接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——隨訪數(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ù)標識FollowUpArchive方法PATCH數(shù)據(jù)類型application/json請求參數(shù)證件類型personcardType證件號personcardNo醫(yī)院代碼hospitalId隨訪時間followUpDate請求體ArchiveData，格式按照DB32/T4155.2—2021的表4和表5進行編寫表9隨訪數(shù)據(jù)更新接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——用藥處方接收.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理用藥處方，支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。.2用藥處方接收服務(wù)的接口請求和接口響應(yīng)分別見表10和表11。表10用藥處方接收的接口請求參數(shù)值服務(wù)標識Prescription方法POSTDB32/T5197—20255表10用藥處方接收的接口請求（續(xù)）參數(shù)值數(shù)據(jù)類型application/json請求體PrescriptionData，數(shù)據(jù)結(jié)構(gòu)按照DB32/T4155.7—2021中表10及表11進行填寫表11用藥處方接收接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——健康教育處方接收.1接口實現(xiàn)的主要功能是服務(wù)發(fā)起方向服務(wù)提供方請求數(shù)據(jù)上傳，用于動態(tài)管理健康教育處方，支持批量操作，并獲取操作結(jié)果；數(shù)據(jù)需要即時同步。.2健康教育處方接收服務(wù)的接口請求見表12，接口請求體的具體數(shù)據(jù)結(jié)構(gòu)請見表13，接口響應(yīng)表12健康教育處方接收接口請求參數(shù)值服務(wù)標識Caring方法POST數(shù)據(jù)類型application/json請求體CaringData表13健康教育處方數(shù)據(jù)結(jié)構(gòu)字段名英文名類型長度必填備注患者證件號PAT_IDVC是身份證號格式，必須唯一門診IDOUTPAT_IDVC是門診識別號疾病名DISEASE_NAMEVC是疾病名稱機構(gòu)INSTITUTIONVC是醫(yī)療機構(gòu)名稱科室DEPARTMENTVC是科室名稱醫(yī)生證件號DOCTOR_IDVC是醫(yī)生的身份證號開單時間PRESCRIPTION_DATETIMEDT是日期時間格式Y(jié)YYYMMDDhhmmss營養(yǎng)建議NUTRITION_PRESCRIPTIONTEXT—是針對特定健康問題的建議或指導(dǎo)運動建議EXERCISE_PRESCRIPTIONTEXT—是針對特定健康問題的運動建議DB32/T5197—20256表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é)果布爾值必要響應(yīng)執(zhí)行結(jié)果狀態(tài)碼Status整數(shù)必要—響應(yīng)狀態(tài)碼消息字符串可選——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ù)標識UserArchive方法GET請求參數(shù)表證件類型personcardType證件號personcardNo表16健康檔案查詢接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(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ù)需要即時同步；DB32/T5197—2025.2服務(wù)列表查詢服務(wù)的接口請求見表17，其中服務(wù)類型枚舉值包括體檢、隨訪、檢驗、檢查、用藥表17服務(wù)列表查詢接口請求參數(shù)值服務(wù)標識ListCheck方法GET請求參數(shù)表證件類型personcardType證件號personcardNo服務(wù)類型type開始日期dateStart結(jié)束日期dateEnd表18服務(wù)列表查詢接口響應(yīng)參數(shù)英文參數(shù)數(shù)據(jù)類型約束值域定義響應(yīng)結(jié)果布爾值必要響應(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_IDVC是服務(wù)執(zhí)行識別號機構(gòu)INSTITUTIONVC是醫(yī)療機構(gòu)名稱執(zhí)行日期PRESCRIPTION_DATED8是日期格式Y(jié)YYYMMDD.3返回的隨訪的數(shù)據(jù)格式應(yīng)按照DB32/T4155.2—2021的表4和表5進行編寫；返回的體檢、檢查、檢驗數(shù)據(jù)格式按照DB32/T4155.6—2021的表4進行編寫；返回的健康教育處方數(shù)據(jù)格式按照表13進行編寫。5.4返回類型返回類型應(yīng)在返回數(shù)據(jù)中標明，返回值中的字段標準參照附錄A。6數(shù)據(jù)傳輸6.1消息實體結(jié)構(gòu)6.1.1消息頭消息頭的構(gòu)成內(nèi)容見表20。用戶權(quán)限管理參照GB/T31504的要求進行設(shè)計與維護。DB32/T5197—20258表20消息頭構(gòu)成成員類型描述eventClassString事件類別，固定值：SYTPeventIdString事件編號，即需要傳輸?shù)臄?shù)據(jù)集編號，例如：DA01eventVersionString事件版本，即數(shù)據(jù)集所在的交換規(guī)范本版號，例如0.1msgIdInt消息的唯一標識createTimeDatetime消息創(chuàng)建時間，格式為YYYYMMDDHHmmssorganizationIdInt消息來源機構(gòu)編號sendSystemIdInt消息來源系統(tǒng)authorityTypeIntuserIdentityString訪問服務(wù)器使用的用戶身份鑒別碼StringauthorityType為2時必填，訪問服務(wù)器使用的權(quán)限鑒別口令StringauthorityType為3時必填，周期性固定身份鑒權(quán)信息，統(tǒng)一頒發(fā)String用于存儲唯一id號（此id要求每次傳輸前生成，保證不重復(fù)）6.1.2消息體按照第5章健康檔案新建、健康檔案更新、隨訪數(shù)據(jù)新建、隨訪數(shù)據(jù)更新、用藥處方接收、健康教育處方接收、健康檔案查詢、服務(wù)列表查詢的要求，基于XMLSchema或者JSON格式進行規(guī)范表示。6.2授權(quán)碼獲取服務(wù)6.2.1用戶調(diào)用服務(wù)接口前，需要先獲取身份認證令牌。6.2.2令牌接口地址設(shè)計為HTTP［S//URL_ADDRPORT］/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)使用具