版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡介
ICS35.240
CCSL67
13
河北省地方標(biāo)準(zhǔn)
DB13/T6066.2—2025
國資數(shù)智化第2部分:數(shù)據(jù)交換接口規(guī)范
2025-04-03發(fā)布2025-05-03實(shí)施
河北省市場監(jiān)督管理局發(fā)布
DB13/T6066.2—2025
前言
本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分:標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)
定起草。
本文件是DB13/T6066《國資數(shù)智化》的第2部分。DB13/T6066已經(jīng)發(fā)布了以下部分:
——第1部分:數(shù)據(jù)元規(guī)范;
——第2部分:數(shù)據(jù)交換接口規(guī)范;
——第3部分:數(shù)據(jù)治理規(guī)范。
請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。
本文件由河北省人民政府國有資產(chǎn)監(jiān)督管理委員會(huì)提出并歸口。
本文件起草單位:河北省人民政府國有資產(chǎn)監(jiān)督管理委員會(huì)信息中心、河鋼數(shù)字技術(shù)股份有限
公司、河北省標(biāo)準(zhǔn)化研究院。
本文件主要起草人:張承東、任國森、孫金海、趙葆青、王宗勇、楊丁凱、劉雅、林靜、丁源、
田昌盛、葛春紅、梁新誠、梁克難、李楠、張辰。
I
DB13/T6066.2—2025
引言
隨著數(shù)字化時(shí)代發(fā)展,國家推動(dòng)數(shù)字化轉(zhuǎn)型,“數(shù)字國資”概念興起。國務(wù)院國資委重視國資
監(jiān)管數(shù)字化智能化,出臺(tái)系列政策構(gòu)建監(jiān)管體系,推動(dòng)國資國企高質(zhì)量發(fā)展,服務(wù)國家治理現(xiàn)代化。
河北省積極響應(yīng),建設(shè)國資國企在線監(jiān)管“數(shù)智化”平臺(tái)。數(shù)據(jù)是該平臺(tái)建設(shè)基礎(chǔ),其規(guī)范化管理
極為關(guān)鍵。本文件分為三個(gè)部分。
——第1部分:數(shù)據(jù)元規(guī)范,目的在于明確國資監(jiān)管數(shù)據(jù)基本單元,規(guī)范數(shù)據(jù)元屬性,保障數(shù)
據(jù)交互一致性與準(zhǔn)確性;
——第2部分:數(shù)據(jù)交換接口規(guī)范,目的在于提供標(biāo)準(zhǔn)接口定義和交互方式,確保數(shù)據(jù)在不同
系統(tǒng)間順暢、安全傳輸,提升系統(tǒng)協(xié)同效率;
——第3部分:數(shù)據(jù)治理規(guī)范,目的在于保障國資監(jiān)管數(shù)據(jù)質(zhì)量,增強(qiáng)可用性、可靠性和安全
性,強(qiáng)化安全管理與隱私保護(hù),全面契合國家的政策法規(guī)。
這三個(gè)部分相互關(guān)聯(lián),共同構(gòu)成完整的國資“數(shù)智化”監(jiān)管體系。
II
DB13/T6066.2—2025
國資數(shù)智化第2部分:數(shù)據(jù)交換接口規(guī)范
1范圍
本文件規(guī)定了河北省國資數(shù)智化平臺(tái)數(shù)據(jù)交換方式和交換接口的要求。
本文件適用于河北省國資數(shù)智化平臺(tái)數(shù)據(jù)交換接口的應(yīng)用。
2規(guī)范性引用文件
下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中,注日期的引用
文件,僅該日期對應(yīng)的版本適用于本文件;不注日期的引用文件,其最新版本(包括所有的修改單)
適用于本文件。
GB/T5271.1信息技術(shù)詞匯第1部分:基本術(shù)語
GB/T41138產(chǎn)品質(zhì)量信息系統(tǒng)信息分類與共享交換
3術(shù)語和定義
GB/T5271.1、GB/T41138界定的術(shù)語和定義適用于本文件。
共享交換sharingandexchange
通過數(shù)據(jù)的采集、處理、存儲(chǔ)和應(yīng)用等過程活動(dòng)在不同方之間傳遞數(shù)據(jù),一定條件下實(shí)現(xiàn)各方
交流和共用數(shù)據(jù)。
[來源:GB/T41138-2021,3.3.3]
接口界面interface
兩個(gè)功能單元共享的邊界,它由各種特征(如功能、物理互連、信號(hào)交換等)來定義。
[來源:GB/T5271.1-2000,01.01.38]
4交換方式
共享交換方式
國資數(shù)據(jù)共享交換方式分為外部數(shù)據(jù)共享交換和內(nèi)部數(shù)據(jù)共享交換兩種:
a)外部數(shù)據(jù)共享交換:依托省級(jí)信息資源共享交換平臺(tái)實(shí)現(xiàn),主要是與同級(jí)部門間的數(shù)據(jù)交
換共享,參與數(shù)據(jù)交換的各業(yè)務(wù)部門通過API接口與信息資源交換共享平臺(tái)進(jìn)行連接,獲
取其他部門的數(shù)據(jù),與第三方數(shù)據(jù)主要通過API接口實(shí)現(xiàn),通過定時(shí)任務(wù),定時(shí)獲取第三
方前置機(jī)接口提供的數(shù)據(jù),并與本地?cái)?shù)據(jù)進(jìn)行比對,將最新數(shù)據(jù)進(jìn)行持久化操作;
b)內(nèi)部數(shù)據(jù)共享交換:通過API接口實(shí)現(xiàn)與國資委各業(yè)務(wù)部門之間的數(shù)據(jù)共享交換。數(shù)據(jù)共
享交換范圍依據(jù)國資委相關(guān)要求進(jìn)行提供。
實(shí)現(xiàn)形式
數(shù)據(jù)共享采用基于Rest的同步請求數(shù)據(jù)交換接口的形式實(shí)現(xiàn)。
通用要求
4.3.1數(shù)據(jù)內(nèi)容
內(nèi)部共享交換數(shù)據(jù)包含(但不限于):國資國企基本信息、組織機(jī)構(gòu)信息、“三重一大”信息、
產(chǎn)權(quán)信息、投資信息等。
外部共享交換數(shù)據(jù)包含(但不限于):產(chǎn)權(quán)信息、投資信息等。
1
DB13/T6066.2—2025
4.3.2交換記錄項(xiàng)
每條數(shù)據(jù)記錄在交換時(shí)需要增加設(shè)置記錄ID(GUID)、記錄入庫時(shí)間、記錄出庫時(shí)間這三個(gè)用于
交換的數(shù)據(jù)項(xiàng)。其中,記錄ID為數(shù)據(jù)記錄指紋,由數(shù)據(jù)生成單位賦值,采用GUID機(jī)制,以標(biāo)識(shí)記錄
的全局唯一性。
4.3.3交換數(shù)據(jù)
在數(shù)據(jù)交換中,漢字使用中文半角,英文字母、數(shù)字和符號(hào)使用英文半角。除正式交換數(shù)據(jù)外,
禁止在任何其他位置輸入其他文字。交換數(shù)據(jù)采用UTF-8編碼格式。
4.3.4傳輸網(wǎng)絡(luò)
省屬監(jiān)管企業(yè)使用專線接入,市級(jí)國資監(jiān)管機(jī)構(gòu)以及市屬企業(yè),縣級(jí)國資監(jiān)管機(jī)構(gòu)以及縣屬企
業(yè)使用政務(wù)云網(wǎng)絡(luò)。
5交換接口
觸發(fā)采集服務(wù)器拉取接口
拉取接口是由業(yè)務(wù)系統(tǒng)有需要上報(bào)數(shù)據(jù)時(shí)觸發(fā)國資委采集服務(wù)器拉取接口。接口要求見表1。
表1觸發(fā)采集服務(wù)器拉取接口
最高調(diào)用頻率1次/5min
請求方式POST
傳參格式JSON字符編碼采用UTF-8
請求路徑http://ip:port/api/DataInterface/pullingInterfacePost
參數(shù)名類型必填說明
keystring是接口Key
sysNamestring是系統(tǒng)名稱(按外部數(shù)據(jù)源創(chuàng)建)
請求參數(shù)SM2公鑰加密的密碼(國資委接口平臺(tái)側(cè)提供,每個(gè)系
passWordstring是
統(tǒng)唯一)
timestamplong是時(shí)間戳(失敗重新提交與首次提交時(shí)間戳保持一致)
typeint是1-首次提交,2-失敗重新提交(避免數(shù)據(jù)重復(fù)提交)
參數(shù)名類型/說明
輸出參數(shù)
statusint/結(jié)果標(biāo)記,0-失敗,1-成功
(JsonObject)
messagestring/消息(接口調(diào)用結(jié)果提示)
請求參數(shù)數(shù)據(jù)示例如下:
{
"key":"",
"sysName":"",
"passWord":"73otYTlp5Tmi5vlvoXmiYAiLAoJCSJjb2RlIjogIjkxMTMwMTAwMTA0MzM5",
"timestamp":1698996672,
"type":1
}
回應(yīng)包失敗原因描述見表2。
2
DB13/T6066.2—2025
表2回應(yīng)包失敗原因
消息原因
sysName錯(cuò)誤請檢查sysName是否正確
時(shí)間戳不能為空請檢查是否傳遞時(shí)間戳timestamp
SM2解析密碼錯(cuò)誤請檢查是否進(jìn)行SM2加密處理,核對加密密鑰是否正確
密碼錯(cuò)誤請檢查passWord是否正確
拉取異常!請檢查拉取接口服務(wù)是否正常,檢查網(wǎng)絡(luò)通訊是否正常,拉取地址是否正確
拉取異常數(shù)據(jù)包過大數(shù)據(jù)包過大,請分包傳輸,數(shù)據(jù)包最大50mb
數(shù)據(jù)格式錯(cuò)誤請檢查數(shù)據(jù)格式,參考請求示例格式標(biāo)準(zhǔn)要求
解析SM4Key失敗請檢查數(shù)據(jù)包SM2加密的SM4是否正確
不能轉(zhuǎn)發(fā),沒有找到對
請檢查指標(biāo)對應(yīng)的系統(tǒng)配置是否正確
應(yīng)指標(biāo)或?qū)?yīng)系統(tǒng)!
輸出參數(shù)數(shù)據(jù)格式:
{
"status":"1",
"message":"成功",
}
輸出參數(shù)數(shù)據(jù)格式:
{
"status":"0",
"message":"sysName錯(cuò)誤",
}
采集服務(wù)器拉取接口
接口要求見表3。
表3采集服務(wù)器拉取接口
請求方式POST
傳參格式JSON字符編碼采用UTF-8
請求路徑上報(bào)系統(tǒng)提供接口地址
參數(shù)名類型必填說明
keystring是接口Key
sysNamestring是系統(tǒng)名稱
請求參數(shù)
passWordstring是SM2公鑰加密的密碼(國資委接口平臺(tái)側(cè)提供)
timestamplong是時(shí)間戳(觸發(fā)接口時(shí)間戳)
typeint是1-首次上報(bào),2-失敗重新提交(避免數(shù)據(jù)重復(fù)提交)
參數(shù)名類型/說明
輸出參數(shù)分3種類型,分別為新增數(shù)據(jù)格式、修改數(shù)據(jù)格
輸出參數(shù)式、刪除數(shù)據(jù)格式,詳見下方表4、表5、表6。根據(jù)輸出
參數(shù)中status字段判斷新增("status":"1")、刪除
(JsonObject)datastring/
("status":"2")、修改("status":"3")狀態(tài)。
下方數(shù)據(jù)示例均為明文示例,正式數(shù)據(jù)請根據(jù)5.6傳輸加
密數(shù)據(jù)(軟件加解密)流程進(jìn)行加密封裝。
注:數(shù)據(jù)包最大50MB,如果超出,請將數(shù)據(jù)包分割成多個(gè)小包后進(jìn)行數(shù)據(jù)傳輸。
請求參數(shù)數(shù)據(jù)示例:
3
DB13/T6066.2—2025
{
"key":"",
"sysName":"",
"passWord":"73otYTlp5Tmi5vlvoXmiYAiLAoJCSJjb2RlIjogIjkxMTMwMTAwMTA0MzM5",
"timestamp":1698996672,
"type":1
}
新增數(shù)據(jù)(輸出參數(shù))格式
新增(輸出參數(shù))數(shù)據(jù)格式要求見表4。
表4新增(輸出參數(shù))數(shù)據(jù)格式
名稱類型必填說明
keystring是接口key
sysNamestring是接口用戶名
statusstring是默認(rèn)值1(新增)
SM4Keystring是SM2加密后的SM4密鑰
dataListList集合是業(yè)務(wù)數(shù)據(jù)(字段僅參考,實(shí)際字段根據(jù)實(shí)際業(yè)務(wù)為準(zhǔn))
輸出參數(shù)數(shù)據(jù)示例:
{
"key":"",
"sysName":"",
"status":"1",
"SM4Key":"",
"dataList":[{
"id":"1",
"name":"XXXX",
"code":"123456789012345678"
},
{
"id":"2",
"name":"XXXX",
"code":"123456789012345678"
}]
}
修改(輸出參數(shù))數(shù)據(jù)格式
修改(輸出參數(shù))數(shù)據(jù)格式要求見表5。
表5修改(輸出參數(shù))數(shù)據(jù)格式
名稱類型必填說明
keystring是接口key
sysNamestring是系統(tǒng)名稱
4
DB13/T6066.2—2025
表5修改(輸出參數(shù))數(shù)據(jù)格式(續(xù))
名稱類型必填說明
statusstring是默認(rèn)值2(修改)
SM4Keystring是SM2加密后的SM4密鑰
majorKeyListList集合是修改數(shù)據(jù)主鍵
dataListList集合是業(yè)務(wù)數(shù)據(jù)(字段僅參考,實(shí)際字段根據(jù)實(shí)際業(yè)務(wù)為準(zhǔn))
輸出參數(shù)數(shù)據(jù)示例:
{
"key":"",
"sysName":"",
"status":"2",
"SM4Key":"",
"majorKeyList":["id","name"],
"dataList":[{
"id":"1",
"name":"XXXX",
"code":"123456789012345678"
},
{
"id":"2",
"name":"XXXX",
"code":"123456789012345678"
}]
}
刪除(輸出參數(shù))數(shù)據(jù)格式
刪除(輸出參數(shù))數(shù)據(jù)格式要求見表6。
表6刪除(輸出參數(shù))數(shù)據(jù)格式
名稱類型必填說明
keystring是接口key
sysNamestring是系統(tǒng)名稱
statusstring是默認(rèn)值3(刪除)
SM4Keystring是SM2加密后的SM4密鑰
majorKeyListList集合是刪除數(shù)據(jù)主鍵
dataListList集合是業(yè)務(wù)數(shù)據(jù)(字段僅參考,實(shí)際字段根據(jù)實(shí)際業(yè)務(wù)為準(zhǔn))
輸出參數(shù)數(shù)據(jù)示例:
{
"key":"",
"sysName":"",
5
DB13/T6066.2—2025
"status":"3",
"SM4Key":"",
"majorKeyList":["id","name"],
"dataList”:[{
"id":"1",
"name":"XXXX",
"code":"123456789012345678"
},
{
"id":"2",
"name":"XXXX",
"code":"123456789012345678"
}]
}
傳輸加密數(shù)據(jù)(軟件加解密)
要求如下:
a)數(shù)據(jù)分為校驗(yàn)參數(shù)部分和業(yè)務(wù)數(shù)據(jù)部分dataList,數(shù)據(jù)字段根據(jù)實(shí)際業(yè)務(wù)需求而定,數(shù)據(jù)
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲(chǔ)空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 智慧家庭推廣承諾書7篇
- 夜空下的愿望作文(5篇)
- 個(gè)人理財(cái)目標(biāo)承諾書(5篇)
- 門窗廠質(zhì)量制度規(guī)范標(biāo)準(zhǔn)
- 環(huán)境監(jiān)測前處理制度規(guī)范
- 門衛(wèi)監(jiān)控室值班制度規(guī)范
- 輸液制度及流程管理規(guī)范
- 重慶市項(xiàng)目管理制度規(guī)范
- 學(xué)生投票制度規(guī)范要求
- 三基建設(shè)內(nèi)部制度規(guī)范
- 2026長治日報(bào)社工作人員招聘勞務(wù)派遣人員5人參考題庫完美版
- 2025年經(jīng)營分析報(bào)告
- 慢性心衰心肌代謝記憶的干細(xì)胞干預(yù)新策略
- 2026年孝昌縣供水有限公司公開招聘正式員工備考題庫有完整答案詳解
- 中建八局項(xiàng)目如何落實(shí)鋼筋精細(xì)化管理
- 鋼結(jié)構(gòu)除銹后油漆施工方案
- 安徽省江南十校2025-2026學(xué)年高一上學(xué)期12月聯(lián)考生物(含答案)
- 杭州市臨平區(qū)2025年網(wǎng)格員招聘筆試必考題庫(含答案)
- 總裁思維培訓(xùn)課件
- 電梯更換配件協(xié)議書
- 中海大海洋地質(zhì)學(xué)課件第12章海底礦產(chǎn)資源-1第二十二講
評(píng)論
0/150
提交評(píng)論