67

12 DB12/T

1231—2023政務(wù)信息資源共享 數(shù)據(jù)交換技術(shù)規(guī)范Government

infomation

resources

sharing

-

Data

exchanging

technique

specification天津市市場(chǎng)監(jiān)督管理委員會(huì)??發(fā)

布DB12/T

12312023 本文件按照GB/T

1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則

第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定DB12/T

12312023

DB12/T

DB12/T

DB12/T

3.4

resource

resource

data

exchanging

government

information

catalog

system3.5

service

management

bus

a)

b)

c)

DB12/T

2023d)

a)

數(shù)據(jù)庫(kù)表交換:通過(guò)前置節(jié)點(diǎn)交換實(shí)現(xiàn),適用于大體量、高時(shí)效性、周期性的結(jié)構(gòu)化數(shù)據(jù)交換景，資源用方通過(guò)享批量獲數(shù)據(jù)，與有數(shù)據(jù)融后可進(jìn)行合業(yè)務(wù)處、統(tǒng)計(jì)分b)

c)

服務(wù)接口交換:通過(guò)服務(wù)管理總線注冊(cè)并發(fā)布服務(wù)接口方式實(shí)現(xiàn),適用于小數(shù)據(jù)包、高頻次、圖1

基于共享交換平臺(tái)的數(shù)據(jù)交換業(yè)務(wù)流程見(jiàn)圖2。a)

b)

源使用方過(guò)共享交平臺(tái)對(duì)資發(fā)起共享請(qǐng)，申請(qǐng)應(yīng)注明數(shù)使用場(chǎng)景聯(lián)系方式c)

據(jù)資源共條件，無(wú)件共享資應(yīng)在共享?yè)Q平臺(tái)備后獲取；條件共享資源，在DB12/T

12312023圖2

7.1

a)

編碼中“/”應(yīng)改為“_”。信息類(lèi)編碼即信息資源目錄類(lèi)編碼，是標(biāo)識(shí)政務(wù)信息資源目錄的

b)

換規(guī)則要字段：除成業(yè)務(wù)字創(chuàng)建外，據(jù)庫(kù)表結(jié)中還應(yīng)增時(shí)間戳及據(jù)狀態(tài)標(biāo)

c)

d)

1)

2)

GUID

GUIDTOPIC_ADD_TIMEDATETIMEDATETIMEVARCHAR(2)I：新增U：修改D：刪除DB12/T

2023表1

資源提供方在準(zhǔn)備、組織數(shù)據(jù)交換時(shí)應(yīng)遵循以下要求：a)

b)

掛接的數(shù)據(jù)庫(kù)表應(yīng)添加唯一標(biāo)識(shí)的主鍵字段，作為數(shù)據(jù)更新的依據(jù)；c)

GUID

GUID

d)

當(dāng)部門(mén)第一次上傳數(shù)據(jù)時(shí)，TOPIC_ADD_TIME

值應(yīng)保持一致（即賦予該

OPERATETYPE

e)

當(dāng)部門(mén)需修改或刪除數(shù)據(jù)內(nèi)容時(shí)，除更新業(yè)務(wù)字段值外，應(yīng)同時(shí)修改

段值為當(dāng)前數(shù)據(jù)寫(xiě)入時(shí)間，OPERATETYPE

f)

OPERATETYPEg)

“0000-00-00

7.2

a)

源注冊(cè)：源提供方過(guò)共享交平臺(tái)注冊(cè)務(wù)信息資，應(yīng)注明源描述、享類(lèi)型、資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“數(shù)據(jù)庫(kù)表”；b)

冊(cè)審核：享交換平對(duì)資源提方發(fā)起的源注冊(cè)進(jìn)審核，審?fù)ㄟ^(guò)后，源目錄狀c)

源掛接審：資源提方將數(shù)據(jù)接到前置點(diǎn)數(shù)據(jù)庫(kù)并將數(shù)據(jù)接狀態(tài)設(shè)為“1)

2)

滿(mǎn)足數(shù)據(jù)量檢查要的，共享?yè)Q平臺(tái)將據(jù)掛接狀調(diào)整為“接不通過(guò)DB12/T

12312023d)

e)

f)

g)

8.1

Windows：d:/tjgx

在前置節(jié)點(diǎn)中創(chuàng)建存放推送或接收文件的文件夾，文件夾命名規(guī)則為“T_”+“信息類(lèi)編碼”，其8.2

a)

源注冊(cè)：源提供方過(guò)共享交平臺(tái)注冊(cè)務(wù)信息資，應(yīng)注明源描述、享類(lèi)型、資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“文件”；b)

冊(cè)審核：享交換平對(duì)資源提方發(fā)起的源注冊(cè)進(jìn)審核，審?fù)ㄟ^(guò)后，源目錄狀c)

源掛接審：資源提方將資源件上傳至置節(jié)點(diǎn)文存放路徑，文件上工具或程d)

e)

源使用方資源申請(qǐng)案通過(guò)后按照文件命名規(guī)則本方前置點(diǎn)指定路中創(chuàng)建資f)

g)

9.1

a)

IP

b)

HTTP

Open

API、RESTful

API、Web

Service

HTTP

Open

API

RESTful

API

URL樣式寫(xiě)明調(diào)用接口的URL樣式寫(xiě)明支持的協(xié)議，如：HTTP

Open

API、RESTful

Service等支持POST、GET、POST/GET等方式對(duì)于特定格式（json、xml格式等）參數(shù)應(yīng)舉例說(shuō)明字符串/json/xml或其他格式應(yīng)舉例說(shuō)明對(duì)特定格式（json、xml、自定義格式等）的返回參數(shù)應(yīng)提供示例說(shuō)明說(shuō)明支持的協(xié)議，如：HTTP

Open

API、Web

DB12/T

2023c)

d)

e)

表2

9.2

a)

b)

接口協(xié)議：接入的接口服務(wù)協(xié)議應(yīng)至少支持

HTTP

Open

API、RESTful

API、Web

Service

c)

d)

e)

表3

9.3

接入規(guī)范/限制具體要求應(yīng)符合表4。接入規(guī)范/限制HTTPHTTPBody：Key-Value/JSON/byte[]形式3.應(yīng)支持RESTful風(fēng)格接入，如：http://localhost:8081/abc/{userId}/search

HTTP1.

應(yīng)使用Authorization與或WSSE格式的用戶(hù)名密碼接入SOAP

Header2.

對(duì)于anytype參數(shù)類(lèi)型，參數(shù)定義時(shí)要經(jīng)過(guò)特殊定義為“ws:anyType”3.

4.

支持的bindType是Document-Literal

(Wrapper

or

Unwrapper)5.

返回結(jié)果是將SOAP

HTTP

1.應(yīng)以SOAP

Service服務(wù)，并提供標(biāo)準(zhǔn)的WSDLDB12/T

12312023表4

DB12/T

2023

A.1

功能說(shuō)明：婚姻信息核驗(yàn)API實(shí)現(xiàn)根據(jù)業(yè)務(wù)請(qǐng)求編號(hào)、身份證號(hào)碼、性別進(jìn)行查詢(xún)，所有查詢(xún)參數(shù)URL樣式：http://localhost:8081/abc/{userId}/search請(qǐng)求方式：POSTURL參數(shù)：返回HTTP狀態(tài)：200返回格式：JSON

code：0msg：rownum：C_NAME：C_BIRTHDAY：BIRTH_CERTIFICATION_NUMBER：FATHER_NAME：FATHER_ETHNIC_GROUP：MOTHER_NAME：MOTHER_ETHNIC_GROUP：DB12/T

12312023