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