DB13∕T 6066.2-2025 國資數(shù)智化 第2部分:數(shù)據(jù)交換接口規(guī)范_第1頁
DB13∕T 6066.2-2025 國資數(shù)智化 第2部分:數(shù)據(jù)交換接口規(guī)范_第2頁
DB13∕T 6066.2-2025 國資數(shù)智化 第2部分:數(shù)據(jù)交換接口規(guī)范_第3頁
DB13∕T 6066.2-2025 國資數(shù)智化 第2部分:數(shù)據(jù)交換接口規(guī)范_第4頁
DB13∕T 6066.2-2025 國資數(shù)智化 第2部分:數(shù)據(jù)交換接口規(guī)范_第5頁
已閱讀5頁,還剩5頁未讀 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(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)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評(píng)論

0/150

提交評(píng)論