DB4201-T 536.2-2017“云端武漢”政務(wù)數(shù)據(jù)資源目錄體系與數(shù)據(jù)交換技術(shù)規(guī)范 第2部分：數(shù)據(jù)共享交換

ICS

35.240.01L

67備案號：0071-2017

DB4201 DB4201/T

536.2—2017“云端武漢”政務(wù)數(shù)據(jù)資源目錄體系與數(shù)據(jù)交換技術(shù)規(guī)范第

2

部分：數(shù)據(jù)共享交換Technical

specifications

government

data

catalog

system

and

data

exchange

Part

data

share

exchange 武漢市質(zhì)量技術(shù)監(jiān)督局武漢市互聯(lián)網(wǎng)信息辦公室發(fā)

布DB4201/T

536.2—2017前言

...............................................................................

III1

范圍

..............................................................................

12

規(guī)范性引用文件

....................................................................

13

術(shù)語與定義

........................................................................

14

縮略語

............................................................................

35

數(shù)據(jù)交換體系總體框架

..............................................................

35.1 總體技術(shù)架構(gòu)

..................................................................

35.2 共享交換服務(wù)建設(shè)流程

..........................................................

36

數(shù)據(jù)共享交換技術(shù)規(guī)范

..............................................................

66.1

概述

..........................................................................

66.2

交換模式

......................................................................

66.3

數(shù)據(jù)接口交換規(guī)則

..............................................................

76.4

前置數(shù)據(jù)庫交換規(guī)則

...........................................................

167

數(shù)據(jù)資源交換管理規(guī)范

.............................................................

247.1

概述

.........................................................................

247.2

角色職責(zé)

.....................................................................

247.3

管理環(huán)節(jié)

.....................................................................

257.4

制度建設(shè)

.....................................................................

26附錄

A（資料性附錄） 政務(wù)共享交換服務(wù)表單示例.......................................

27附錄

B（資料性附錄） 數(shù)據(jù)接口參數(shù)示例...............................................

28附錄

C（資料性附錄）

調(diào)用示例

...................................................

32參考文獻

............................................................................

35DB4201/T

536.2—2017 本標準按照GB/T

《標準化工作導(dǎo)則 第1部分：標準的結(jié)構(gòu)和編寫》給出的規(guī)則起草。本標準由武漢市互聯(lián)網(wǎng)信息辦公室提出并歸口。本標準起草單位：武漢市信息中心、武漢市標準化研究院。本標準主要起草人：王留軍、袁遠明、崔新強、黃勇、張潔、肖迎霜、董波濤、向小雪、李文、劉肖駿。DB4201/T

536.2—2017

1范圍本標準規(guī)定了“云端武漢”政務(wù)數(shù)據(jù)共享交換中的術(shù)語與定義、縮略語、數(shù)據(jù)交換體系總體框架、數(shù)據(jù)共享交換技術(shù)規(guī)范、數(shù)據(jù)資源交換管理規(guī)范。共享交換政務(wù)數(shù)據(jù)資源。2規(guī)范性引用文件件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。武政辦[2015]146號 《武漢市政務(wù)數(shù)據(jù)資源共享管理暫行辦法》武網(wǎng)發(fā)[2016]9號 《武漢市政務(wù)云平臺數(shù)據(jù)資源安全管理實施細則》3 術(shù)語與定義下列術(shù)語和定義適用于本文件。3.1行政主管部門 administrative

department行政機關(guān)或者其他依法經(jīng)授權(quán)、受委托行使行政職能的組織。3.2武漢政務(wù)云數(shù)據(jù)中心

government

cloud

center的數(shù)據(jù)共享提供支撐的技術(shù)服務(wù)平臺。簡稱“數(shù)據(jù)中心”。3.3政務(wù)數(shù)據(jù)資源

data

resource合。3.4DB4201/T

數(shù)據(jù)項

item各行政主管部門可共享的單個政務(wù)數(shù)據(jù)資源不可再分割的組成元素。3.5服務(wù)及服務(wù)項

service

item數(shù)據(jù)項操作的集合，數(shù)據(jù)項可來自于多個政務(wù)數(shù)據(jù)資源，而服務(wù)是整個服務(wù)項集合的總稱。3.6數(shù)據(jù)需求方

demand

side指通過數(shù)據(jù)中心獲取政務(wù)數(shù)據(jù)資源的各行政主管部門。3.7管理者

manager指數(shù)據(jù)中心的運維單位。3.83.9

數(shù)據(jù)提供方

指向數(shù)據(jù)中心提供數(shù)據(jù)資源的各行政主管部門。共享交換服務(wù)

exchange

service的數(shù)據(jù)資源由各行政主管部門自身的業(yè)務(wù)信息系統(tǒng)所提供、產(chǎn)生、發(fā)布并進行運行管理。3.10共享信息服務(wù)系統(tǒng)

information

對各行政主管部門提供的共享交換服務(wù)及接口統(tǒng)一維護管理的平臺系統(tǒng)。3.11接口

interface形式包含：數(shù)據(jù)接口、前置數(shù)據(jù)庫兩種。3.12訪問密鑰標識/秘密訪問密鑰

API_key/

API_secret根據(jù)非對稱加密的方法來驗證某個請求者身份。DB4201/T

536.2—20173.13會話

指用戶與服務(wù)器進行的一次交互，包括從發(fā)起到退出的整個過程。4 縮略語下列縮略語適用于本文件。HTTP：超文本傳輸協(xié)議（HyperText

）API：應(yīng)用程序編程接口（Application

Interface）URL：統(tǒng)一資源定位符（

Resource

Locator）XML：可擴展標記語言（

）5 數(shù)據(jù)交換體系總體框架5.1 總體技術(shù)架構(gòu)5.1.1 組成政務(wù)數(shù)據(jù)共享交換體系技術(shù)總體架構(gòu)包括交換信息庫和共享交換服務(wù)系統(tǒng)兩方面組成。5.1.2 交換信息庫提供的共享交換服務(wù)信息。5.1.3 共享交換服務(wù)系統(tǒng) 前置數(shù)據(jù)庫子系統(tǒng)用系統(tǒng)的獨立性。 數(shù)據(jù)接口子系統(tǒng)為各行政主管部門對外共享交換服務(wù)數(shù)據(jù)接口提供注冊、掛接、配置、授權(quán)等管理。交換管理子系統(tǒng)實現(xiàn)對整個數(shù)據(jù)交換過程的配置、部署、執(zhí)行和整個共享交換服務(wù)系統(tǒng)運行進行監(jiān)控、管理。5.2 共享交換服務(wù)建設(shè)流程如圖1所示，共享交換服務(wù)建設(shè)包括4個環(huán)節(jié)：a)市政務(wù)數(shù)據(jù)主管部門；DB4201/T

b)

5

后提交市政務(wù)數(shù)據(jù)主管部門備案；c) 展設(shè)計開發(fā)，并由數(shù)據(jù)中心工作人員完成該項數(shù)據(jù)服務(wù)的對接工作，全部工作應(yīng)在

30

日內(nèi)完成；d) 考核：市政務(wù)數(shù)據(jù)主管部門對各部門數(shù)據(jù)共享工作響應(yīng)程度、實施進度、工作質(zhì)量進行考核。管部門將取消其通過數(shù)據(jù)中心共享其他部門數(shù)據(jù)的資格。數(shù)據(jù)需求方數(shù)據(jù)中心數(shù)據(jù)提供方開始整理辦事事項涉及的共享數(shù)據(jù)資源及相關(guān)信息創(chuàng)建服務(wù)申請單登記所需數(shù)據(jù)項和對應(yīng)政務(wù)部門拒絕結(jié)束申請與反審核服務(wù)

同意申請單已有收集各政務(wù)部門反饋結(jié)果服務(wù)接口實施掛接通知結(jié)果給服務(wù)涉及相關(guān)政務(wù)部門提供方結(jié)合需求方申請內(nèi)容，給出反饋意見與需求方、提供方協(xié)商協(xié)商結(jié)果形成需求方、提供方、管理方的三方確認單行政機關(guān)是否已有相關(guān)服務(wù)沒有各政務(wù)部門分別進行新建服務(wù)工作DB4201/T

536.2—2017圖1 共享交換服務(wù)建設(shè)流程圖5.2.1 政務(wù)數(shù)據(jù)共享交換申請單各行政主管部門登記共享交換服務(wù)申請內(nèi)容，需按照附錄A中表A.1進行相關(guān)信息填寫。5.2.2 政務(wù)數(shù)據(jù)共享交換確認單A中表信息填寫。…

...DB4201/T

…

...6 數(shù)據(jù)共享交換技術(shù)規(guī)范6.1 概述規(guī)范要求，同時也為第三方相關(guān)單位的研發(fā)工作提供標準依據(jù)。6.2 交換模式6.2.1 數(shù)據(jù)接口類型各行政主管部門的數(shù)據(jù)接口，應(yīng)遵循如圖2所示的交換模式進行政務(wù)數(shù)據(jù)資源交換。各數(shù)據(jù)提供方封裝整理后，統(tǒng)一返回至各數(shù)據(jù)需求方。數(shù)據(jù)提供方公安 民政 工商數(shù)據(jù)接口 數(shù)據(jù)接口 數(shù)據(jù)接口共享信息服務(wù)系統(tǒng)根據(jù)注冊發(fā)布的數(shù)據(jù)接口信息，分別調(diào)取訪問共享信息服務(wù)系統(tǒng)API認證機制注冊

發(fā)布接口注冊

發(fā)布接口

接口訂閱

授權(quán)管理

監(jiān)控

管理

...統(tǒng)一訪問共享信息服務(wù)系統(tǒng)，調(diào)取授權(quán)范圍內(nèi)的數(shù)據(jù)接口公安數(shù)據(jù)接口

民政數(shù)據(jù)接口

工商數(shù)據(jù)接口

共享信息服務(wù)系統(tǒng)封裝返回結(jié)果，統(tǒng)一返回各政務(wù)部門…

...數(shù)據(jù)需求方圖2 數(shù)據(jù)接口交換模式示意圖DB4201/T

536.2—20176.2.2 前置數(shù)據(jù)庫類型利用數(shù)據(jù)中心采用數(shù)據(jù)庫模式進行政務(wù)數(shù)據(jù)交換的各行政主管部門，應(yīng)遵循如圖

3

發(fā)布，根據(jù)定時抓取、定時推送或

上傳文件導(dǎo)入三種形式，將各行政主管部門業(yè)務(wù)數(shù)據(jù)傳至共享接口、

文件導(dǎo)出三種方式，訪問自身權(quán)限范圍內(nèi)的數(shù)據(jù)業(yè)務(wù)表信息。數(shù)據(jù)提供方公安數(shù)據(jù)庫

民政數(shù)據(jù)庫

工商數(shù)據(jù)庫

…

...注冊

發(fā)布數(shù)據(jù)業(yè)務(wù)表

業(yè)務(wù)表注冊

發(fā)布數(shù)據(jù)業(yè)務(wù)表

業(yè)務(wù)表訂閱

授權(quán)管理

監(jiān)控...件導(dǎo)入等方式，將提供方政務(wù)數(shù)據(jù)傳至前置交換區(qū)共享信息服務(wù)系統(tǒng)前置交換區(qū)數(shù)據(jù)庫管理統(tǒng)一訪問共享信息服務(wù)系統(tǒng)，查閱授權(quán)范圍內(nèi)的業(yè)務(wù)表公安數(shù)據(jù)庫

民政數(shù)據(jù)庫

工商數(shù)據(jù)庫

共享信息服務(wù)系統(tǒng)封裝返回結(jié)果，統(tǒng)一返回各政務(wù)部門…

...數(shù)據(jù)需求方圖3 前置數(shù)據(jù)庫交換模式示意圖6.3 數(shù)據(jù)接口交換規(guī)則6.3.1 數(shù)據(jù)接口管理流程 數(shù)據(jù)接口注冊、發(fā)布流程各數(shù)據(jù)提供方的數(shù)據(jù)接口在共享信息服務(wù)系統(tǒng)中集中注冊、掛接、發(fā)布，其工作流程如圖4注冊發(fā)布包括6個環(huán)節(jié)：DB4201/T

a) 中心管理員申請；b) 登記、注冊：由各數(shù)據(jù)提供方行政主管部門登記自身對外提供的接口及相關(guān)參數(shù)信息；c) 提交：由行政主管部門提交發(fā)布申請至數(shù)據(jù)中心；d) 審核：由平臺中心對各行政主管部門的數(shù)據(jù)接口內(nèi)容進行審核；e) 口是否運行正常；f) 接口，查閱相關(guān)的描述說明，并申請數(shù)據(jù)接口的訪問權(quán)限。DB4201/T

536.2—2017圖4 數(shù)據(jù)接口注冊、發(fā)布流程圖數(shù)據(jù)需求方數(shù)據(jù)中心開始選擇所需數(shù)據(jù)接口提出訂閱申請www.b提交審核不通過審核訂閱申請通過分配訪問權(quán)限配置、測試接口測試成功結(jié)束DB4201/T

數(shù)據(jù)接口訂閱、授權(quán)流程進行調(diào)取授權(quán)，其工作流程如圖54個環(huán)節(jié)：a) 申請：各數(shù)據(jù)需求方通過共享信息服務(wù)系統(tǒng)統(tǒng)一提出對已發(fā)布數(shù)據(jù)接口的調(diào)取申請；b) 審核：由平臺中心對各行政主管部門的數(shù)據(jù)接口訂閱請求進行審核；c) 授權(quán)：為各數(shù)據(jù)需求方授權(quán)相應(yīng)的數(shù)據(jù)接口調(diào)取權(quán)限；d) 方成功獲取所需的接口數(shù)據(jù)。圖5 數(shù)據(jù)接口訂閱、授權(quán)流程圖方成功獲取所需的接口數(shù)據(jù)。10DB4201/T

536.2—20176.3.2 技術(shù)要求 提供方數(shù)據(jù)接口發(fā)布規(guī)范.1 數(shù)據(jù)接口示例數(shù)據(jù)提供方所發(fā)布的數(shù)據(jù)接口內(nèi)容，參照附錄B表示例進行描述。.2 接口命名規(guī)范數(shù)據(jù)提供方數(shù)據(jù)接口的命名遵循以下規(guī)則：a) 名為無縫連寫，首詞匯采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；b)稱前增加“虛擬名稱”用于區(qū)分不同的行政主管部門。最終格式例如：“虛擬名稱.真實數(shù)據(jù)接口名稱（gaj.getPersonByIDCard）”；c) 虛擬名稱命名應(yīng)為半角格式的英文無縫連寫；d) 本規(guī)則范圍內(nèi)不允許接口的命名與其對應(yīng)版本號同時重復(fù)。.3 數(shù)據(jù)接口基礎(chǔ)屬性規(guī)范地址、訪問帳號、訪問密碼、提供方名稱、技術(shù)聯(lián)系人、聯(lián)系人電話，屬性具體說明如下：a) 接口版本號定義：描述數(shù)據(jù)接口的版本信息注解：必選項；最大出現(xiàn)次數(shù)為1b) 接口描述定義：描述數(shù)據(jù)接口的功能作用注解：必選項；最大出現(xiàn)次數(shù)為1c)接口類型定義：描述數(shù)據(jù)接口的訪問方式類型注解：必選項；最大出現(xiàn)次數(shù)為1d) 返回報文類型定義：描述調(diào)取本數(shù)據(jù)接口返回報文的格式類型（或格式）注解：必選項；最大出現(xiàn)次數(shù)為1e) 訪問地址定義：描述數(shù)據(jù)接口的調(diào)取訪問地址注解：必選項；最大出現(xiàn)次數(shù)為1f) 訪問帳號定義：描述調(diào)取數(shù)據(jù)接口時所需的帳號注解：必選項；最大出現(xiàn)次數(shù)為1g) 訪問密碼定義：描述調(diào)取數(shù)據(jù)接口時所需的密碼注解：必選項；最大出現(xiàn)次數(shù)為1h) 提供方名稱定義：數(shù)據(jù)接口提供單位名稱DB4201/T

注解：必選項；最大出現(xiàn)次數(shù)為1i) 技術(shù)聯(lián)系人定義：負責(zé)數(shù)據(jù)接口對接調(diào)試工作技術(shù)人員姓名注解：必選項；最大出現(xiàn)次數(shù)為1j) 聯(lián)系人電話定義：負責(zé)數(shù)據(jù)接口對接調(diào)試工作技術(shù)人員的手機號碼或座機號碼注解：必選項；最大出現(xiàn)次數(shù)為.4 請求參數(shù)規(guī)范調(diào)取數(shù)據(jù)提供方數(shù)據(jù)接口所需的各請求參數(shù)描述應(yīng)遵循以下規(guī)則：a) 各參數(shù)命名應(yīng)由半角格式的英文、數(shù)字或“_”符號組成，不允許包含全角格式、漢字或其他特殊字符，所有數(shù)據(jù)接口的請求參數(shù)為無縫連寫；b) 各參數(shù)首詞匯全部采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；c) 如下：1) 名稱定義：描述請求參數(shù)的英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 類型定義：描述請求參數(shù)對應(yīng)的數(shù)據(jù)類型注解：必選項；最大出現(xiàn)次數(shù)為

13) 數(shù)據(jù)長度定義：描述請求參數(shù)最大長度限制注解：必選項；最大出現(xiàn)次數(shù)為

14) 是否必須定義：描述請求參數(shù)是否為必填項注解：必選項；最大出現(xiàn)次數(shù)為

15) 默認值內(nèi)容注解：可選項；最大出現(xiàn)次數(shù)為

16) 描述定義：說明請求參數(shù)的含義及用途注解：必選項；最大出現(xiàn)次數(shù)為

.5 響應(yīng)參數(shù)規(guī)范數(shù)據(jù)提供方數(shù)據(jù)接口的響應(yīng)返回結(jié)果中各參數(shù)描述應(yīng)遵循以下規(guī)則：a) 各參數(shù)命名應(yīng)由半角格式的英文、數(shù)字或“_”符號組成，不允許包含全角格式、漢字或其他特殊字符，所有數(shù)據(jù)接口的響應(yīng)參數(shù)為無縫連寫；b) 各參數(shù)首詞匯全部采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；c) 所有的響應(yīng)數(shù)據(jù)編碼皆為

utf-8

格式；d) 每個響應(yīng)參數(shù)的屬性包括：名稱、類型、數(shù)據(jù)長度、示例值、描述，屬性具體說明如下：12DB4201/T

536.2—20171) 名稱定義：描述響應(yīng)參數(shù)的英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 類型定義：描述請求參數(shù)對應(yīng)的數(shù)據(jù)類型注解：必選項；最大出現(xiàn)次數(shù)為

13) 數(shù)據(jù)長度定義：描述響應(yīng)參數(shù)最大長度限制注解：必選項；最大出現(xiàn)次數(shù)為

14) 示例值定義：描述響應(yīng)參數(shù)的示例數(shù)值，為需求方提供返回示例注解：必選項；最大出現(xiàn)次數(shù)為

15) 描述定義：說明響應(yīng)參數(shù)的含義及用途注解：必選項；最大出現(xiàn)次數(shù)為

.6 錯誤結(jié)果參數(shù)規(guī)范調(diào)取數(shù)據(jù)提供方數(shù)據(jù)接口出現(xiàn)錯誤時，其返回結(jié)果內(nèi)容應(yīng)遵循以下規(guī)則：a) 各參數(shù)命名應(yīng)為半角格式的英文、數(shù)字或“_”符號組成，不允許包含全角格式、漢字或其他特殊字符，所有數(shù)據(jù)接口的錯誤結(jié)果參數(shù)為無縫連寫；b) 各參數(shù)首詞匯全部采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；c) 每個錯誤結(jié)果參數(shù)的屬性包括：名稱、類型、數(shù)據(jù)長度、示例值、描述，屬性具體說明如下：1) 名稱定義：描述錯誤結(jié)果參數(shù)的英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 類型定義：描述錯誤結(jié)果參數(shù)對應(yīng)的數(shù)據(jù)類型注解：必選項；最大出現(xiàn)次數(shù)為

13) 數(shù)據(jù)長度定義：描述錯誤結(jié)果參數(shù)最大長度限制注解：必選項；最大出現(xiàn)次數(shù)為

14) 示例值定義：描述錯誤結(jié)果參數(shù)的示例數(shù)值，為需求方提供返回錯誤結(jié)果示例注解：必選項；最大出現(xiàn)次數(shù)為

15) 描述定義：說明錯誤結(jié)果參數(shù)的含義及用途注解：必選項；最大出現(xiàn)次數(shù)為

.7 錯誤代碼定義數(shù)據(jù)提供方數(shù)據(jù)接口應(yīng)包括錯誤代碼及其對應(yīng)的描述說明，每個錯誤代碼定義的屬性包括：錯誤代碼、錯誤消息、錯誤說明，屬性具體說明如下：a) 錯誤代碼13DB4201/T

定義：描述錯誤結(jié)果參數(shù)的代碼編號注解：必選項；最大出現(xiàn)次數(shù)為

1b) 錯誤消息定義：描述錯誤代碼對應(yīng)的錯誤消息內(nèi)容注解：可選項；最大出現(xiàn)次數(shù)為

1c) 錯誤說明定義：描述錯誤代碼對應(yīng)的中文描述注解：必選項；最大出現(xiàn)次數(shù)為

需求方數(shù)據(jù)接口使用規(guī)范.1 訪問地址規(guī)范數(shù)據(jù)需求方調(diào)取提供方數(shù)據(jù)接口時，其訪問地址為共享信息服務(wù)系統(tǒng)提供的統(tǒng)一訪問

URL。URL的格式例如：公共訪問

地址公共請求參數(shù)+業(yè)務(wù)請求參數(shù)。URL

地址參數(shù)說明：a) URL

地址中各參數(shù)應(yīng)由半角格式的英文、數(shù)字或“_”符號組成，不允許包含全角格式、漢字或其他特殊字符，所有數(shù)據(jù)接口的請求參數(shù)為無縫連寫；b) URL

地址中各參數(shù)首詞匯全部采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；c) URL

里的所有請求參數(shù)名和參數(shù)值的數(shù)據(jù)編碼皆為

utf-8

格式；d) 參數(shù)名與參數(shù)值拼裝起來的

長度小于

個字符時，可以用

發(fā)起請求；參數(shù)類型含byte[]類型或拼裝完成的請求

過長時，應(yīng)用

發(fā)起請求；e) 公共請求參數(shù)詳見

公共請求參數(shù)規(guī)范章節(jié)；f) 業(yè)務(wù)請求參數(shù)詳見

請求參數(shù)規(guī)范章節(jié)。.2 公共請求參數(shù)規(guī)范數(shù)據(jù)需求方在調(diào)取數(shù)據(jù)接口時，應(yīng)按照共享信息服務(wù)系統(tǒng)要求，傳入系統(tǒng)所需的公共請求參數(shù)，公共請求參數(shù)描述遵循以下規(guī)則：a)各參數(shù)命名應(yīng)由半角格式的英文、數(shù)字或“_”符號組成，不允許包含全角格式、漢字或其他特殊字符，所有公共請求參數(shù)為無縫連寫；b)各參數(shù)首詞匯全部采用小寫字母，其余每個詞匯的縮寫的首字母采用大寫；c) 每個公共請求參數(shù)的屬性包括：名稱、類型、是否必須、默認值、描述，屬性具體說明如下：1) 名稱定義：描述公共請求參數(shù)的英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 類型定義：描述公共請求參數(shù)對應(yīng)的數(shù)據(jù)類型注解：必選項；最大出現(xiàn)次數(shù)為

13) 數(shù)據(jù)長度定義：描述公共請求參數(shù)最大長度限制注解：必選項；最大出現(xiàn)次數(shù)為

14) 是否必須定義：描述公共請求參數(shù)是否為必填項注解：必選項；最大出現(xiàn)次數(shù)為

114名稱類型數(shù)據(jù)長度是否必須默認值描述methodString20api_keyString50API_KeyString10，時區(qū)為，例如：2016-01-01

10String1.0String2048DB4201/T

536.2—20175) 默認值數(shù)值內(nèi)容注解：可選項；最大出現(xiàn)次數(shù)為

16)描述定義：說明公共請求參數(shù)的含義及用途注解：必選項；最大出現(xiàn)次數(shù)為

1d) 目前梳理的公共請求參數(shù)如表

1

所示。表1 數(shù)據(jù)接口訪問公共請求參數(shù)表.3 數(shù)據(jù)接口示例共享信息服務(wù)系統(tǒng)向數(shù)據(jù)需求方提供所需數(shù)據(jù)接口調(diào)取方式，如附錄

B

表

B.2

示例所示。 認證機制.1 API

認證簡介為保證數(shù)據(jù)接口訪問調(diào)取的安全性，防止惡意、超權(quán)限訪問數(shù)據(jù)接口，各數(shù)據(jù)需求方行政主管部

API_Secret加密的方法來驗證各行政主管部門身份，API_Key

(以下簡稱為“AK”)是系統(tǒng)為每個訪問者分配的唯一標識；API_Secret

(AS”)“AS”與請求參數(shù)信息組合加密形成需求方的驗證密匙，具體方法詳見

簽名算法章節(jié)描述。AS

信息嚴格保密，僅限行政主管部門管理員和數(shù)據(jù)中心管理員有權(quán)查閱。.2 API

認證方式共享信息服務(wù)系統(tǒng)獲取各數(shù)據(jù)需求方發(fā)送的

HTTP

a) 獲取數(shù)據(jù)需求方的

若存在，則執(zhí)行后續(xù)的驗證工作；b)根據(jù)簽名算法得出本次數(shù)據(jù)接口調(diào)取請求的合法簽名內(nèi)容，與數(shù)據(jù)需求方請求時提供的

值比對，若不一致，系統(tǒng)將拒絕該請求；若一致，則執(zhí)行后續(xù)的驗證工作；15DB4201/T

c)求：“服務(wù)器接收到請求時間<{timestamp}+10min”；其中，timestamp代表需求方調(diào)取數(shù)據(jù)接口的請求時間。10分鐘行操作。.3 簽名算法為了防止調(diào)取

API

數(shù)據(jù)接口過程中被黑客惡意篡改，數(shù)據(jù)需求方在調(diào)取任何一個

API

sign

MD5

內(nèi)容過程如下：a) 對所有

API

參數(shù)和

byte[]據(jù)參數(shù)名稱的

ASCII

碼表的順序排序。如：foo=1,

bar=2,

foo_bar=3,

foobar=4

序是

foo=1,

foo_bar=3,

；b)將排序好的參數(shù)名和參數(shù)值拼裝在一起，根據(jù)上一步的示例得到的結(jié)果為：bar2foo1foo_bar3foobar4；c) 把拼裝好的字符串采用

算法，在拼裝的字符串前后加上

API

，再進行摘要，如：md5(AS+bar2foo1foo_bar3foobar4+AS)；d) 將進行摘要后所得到的字節(jié)流結(jié)果統(tǒng)一轉(zhuǎn)成大寫字母。6.4 前置數(shù)據(jù)庫交換規(guī)則6.4.1 前置數(shù)據(jù)庫管理流程 數(shù)據(jù)庫業(yè)務(wù)表注冊、發(fā)布流程.1 定時抓取模式各數(shù)據(jù)提供方的數(shù)據(jù)庫業(yè)務(wù)表在共享信息服務(wù)系統(tǒng)中集中注冊、掛接、發(fā)布，由共享信息服務(wù)系統(tǒng)定時抓取各數(shù)據(jù)提供方的數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)模式的工作流程如圖

6

所示，注冊發(fā)布包括

4

個環(huán)節(jié)：a) 紙質(zhì)或電子文檔形式完成）；b)登記、注冊：由數(shù)據(jù)中心管理員登記各數(shù)據(jù)提供方的業(yè)務(wù)數(shù)據(jù)庫相關(guān)信息；c) 置、調(diào)試前置交換區(qū)抓取各數(shù)據(jù)提供方數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)功能；d)訪問權(quán)限。16數(shù)據(jù)提供方數(shù)據(jù)中心開始提交自身數(shù)據(jù)庫及業(yè)務(wù)表相關(guān)信息（線下）www.b登記、注冊數(shù)據(jù)庫業(yè)務(wù)表信息配置、測試數(shù)據(jù)抓取測試成功發(fā)布結(jié)束DB4201/T

536.2—2017圖6 數(shù)據(jù)庫注冊、發(fā)布流程圖（定時抓取模式）.2 定時推送模式各數(shù)據(jù)提供方的數(shù)據(jù)庫業(yè)務(wù)表在共享信息服務(wù)系統(tǒng)中集中注冊、掛接、發(fā)布，由各數(shù)據(jù)提供方定時推送自身數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)至共享信息服務(wù)系統(tǒng)模式的工作流程如圖74a)或電子文檔形式完成）；b)數(shù)據(jù)庫表結(jié)構(gòu)；c)業(yè)務(wù)表數(shù)據(jù)功能是否正常（線下完成）；d) 限。17數(shù)據(jù)提供方數(shù)據(jù)中心開始提交自身業(yè)務(wù)表相關(guān)信息（線下）配置、測試數(shù)據(jù)推送www.b分配交換區(qū)發(fā)布結(jié)束DB4201/T

圖7 數(shù)據(jù)庫注冊、發(fā)布流程圖（定時推送模式）.3FTP

文件上傳模式各數(shù)據(jù)提供方的數(shù)據(jù)庫業(yè)務(wù)表在共享信息服務(wù)系統(tǒng)中集中注冊、掛接、發(fā)布，由各數(shù)據(jù)提供方將自身數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)制作成相關(guān)文件導(dǎo)入至共享信息服務(wù)系統(tǒng)模式的工作流程如圖

8

包括

4

個環(huán)節(jié)：a) 或電子文檔形式完成）；b) 結(jié)構(gòu)；c)

換區(qū)導(dǎo)入自身數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)功能是否正常（線下完成）；d) 務(wù)表的訪問權(quán)限。18數(shù)據(jù)提供方數(shù)據(jù)中心開始提交自身業(yè)務(wù)表相關(guān)信息（線下）配置、測試FTP上傳文件導(dǎo)入測www.b分配交換區(qū)發(fā)布結(jié)束DB4201/T

536.2—2017圖8 數(shù)據(jù)庫注冊、發(fā)布流程圖（FTP

文件上傳模式） 數(shù)據(jù)庫業(yè)務(wù)表訂閱、授權(quán)流程各數(shù)據(jù)需求方通過共享信息服務(wù)系統(tǒng)統(tǒng)一提出申請，由數(shù)據(jù)中心管理員審核授權(quán)對所選數(shù)據(jù)庫業(yè)務(wù)表進行訪問。具體工作流程如圖

9

所示，訂閱授權(quán)包括以下

4

個環(huán)節(jié)：a)申請：各數(shù)據(jù)需求方通過共享信息服務(wù)系統(tǒng)統(tǒng)一提出對已發(fā)布數(shù)據(jù)庫業(yè)務(wù)表的訪問申請；b) 審核：由平臺中心對各數(shù)據(jù)需求方的數(shù)據(jù)庫業(yè)務(wù)表訂閱請求進行審核；c) 授權(quán)：為各數(shù)據(jù)需求方授權(quán)相應(yīng)的數(shù)據(jù)庫業(yè)務(wù)表訪問權(quán)限；d) 需求方成功獲取所需的業(yè)務(wù)表數(shù)據(jù)。19數(shù)據(jù)需求方數(shù)據(jù)中心開始選擇所需數(shù)據(jù)庫業(yè)務(wù)表提出訂閱申請?zhí)峤粚徍藈ww.b不通過審核訂閱申請通過分配訪問權(quán)限配置、測試測試成功結(jié)束DB4201/T

圖9 數(shù)據(jù)庫業(yè)務(wù)表訂閱、授權(quán)流程圖6.4.2技術(shù)要求 建表規(guī)范創(chuàng)建前置交換區(qū)表結(jié)構(gòu)需遵循以下規(guī)范：a)前置交換區(qū)數(shù)據(jù)庫類型目前暫定為

Oracle，所有業(yè)務(wù)表均建成“周期快照事實”，后續(xù)可根據(jù)實際需要擴展其他類型格式的數(shù)據(jù)庫；b)

期分區(qū)。每個分區(qū)內(nèi)含本周期全量數(shù)據(jù)，歷史表數(shù)據(jù)保留半年（例如：8

月

1

日，清空當(dāng)年

1月份歷史數(shù)據(jù)）；c)

要分區(qū)。每個表內(nèi)含本周期全量數(shù)據(jù)，歷史表數(shù)據(jù)根據(jù)存儲情況制定保留方案；20DB4201/T

536.2—2017d)

100

8

月

1

日，清空當(dāng)年

1

月份歷史數(shù)據(jù)）；e)

100

案；f) 據(jù)，歷史表數(shù)據(jù)根據(jù)存儲情況制定保留方案；g) 每張業(yè)務(wù)表中新增時間戳字段（，以下簡稱“時間戳”），用于記錄每條數(shù)據(jù)的更新傳輸時間。字段具體的賦值方式詳見后文各更新傳輸數(shù)據(jù)模式規(guī)范中描述介紹；h)內(nèi)各字段具體的賦值方式詳見各更新傳輸數(shù)據(jù)模式規(guī)范中的描述介紹。提供方規(guī)范.1 數(shù)據(jù)庫配置參數(shù)示例數(shù)據(jù)中心管理員為每個提供方分配前置交換區(qū)數(shù)據(jù)庫，建立相應(yīng)表結(jié)構(gòu)時，需要各數(shù)據(jù)提供方按附錄

B

表

B.3

示例出示的相關(guān)參數(shù)填寫。.2數(shù)據(jù)庫配置參數(shù)說明結(jié)合上述數(shù)據(jù)庫配置參數(shù)示例，各參數(shù)要求如下：a) 提供方名稱定義：描述提供數(shù)據(jù)庫信息的單位名稱注解：必選項；最大出現(xiàn)次數(shù)為

1b) 數(shù)據(jù)庫名稱定義：描述數(shù)據(jù)提供方業(yè)務(wù)數(shù)據(jù)庫英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

1c) 數(shù)據(jù)庫類型根據(jù)實際需要擴展其他類型格式的數(shù)據(jù)庫注解：必選項；最大出現(xiàn)次數(shù)為

1d) 數(shù)據(jù)庫

IP

地址定義：描述提供方業(yè)務(wù)數(shù)據(jù)庫

地址注解：必選項；最大出現(xiàn)次數(shù)為

1e) 數(shù)據(jù)庫

MAC

地址定義：描述提供方業(yè)務(wù)數(shù)據(jù)庫

地址注解：可選項；最大出現(xiàn)次數(shù)為

1f) 端口定義：描述提供方業(yè)務(wù)數(shù)據(jù)庫對應(yīng)端口內(nèi)容注解：必選項；最大出現(xiàn)次數(shù)為

1g) 用戶名定義：描述訪問提供方業(yè)務(wù)數(shù)據(jù)庫時需登錄的用戶名21DB4201/T

注解：必選項；最大出現(xiàn)次數(shù)為

1h)密碼定義：描述訪問提供方業(yè)務(wù)數(shù)據(jù)庫時需登錄的密碼注解：必選項；最大出現(xiàn)次數(shù)為

1i) 技術(shù)聯(lián)系人定義：負責(zé)數(shù)據(jù)接口對接調(diào)試工作技術(shù)人員姓名注解：必選項；最大出現(xiàn)次數(shù)為

1j) 聯(lián)系人電話定義：負責(zé)數(shù)據(jù)接口對接調(diào)試工作技術(shù)人員的手機號碼或座機號碼注解：必選項；最大出現(xiàn)次數(shù)為

1k) 業(yè)務(wù)表信息定義：描述提供方數(shù)據(jù)庫各業(yè)務(wù)表的相關(guān)信息，包含業(yè)務(wù)表名稱、業(yè)務(wù)表說明、業(yè)務(wù)表更新頻率、業(yè)務(wù)表當(dāng)前記錄數(shù)、業(yè)務(wù)表每周期更新數(shù)據(jù)量、業(yè)務(wù)表數(shù)據(jù)保存周期六個子屬性，以下逐一介紹注解：必選項；最大出現(xiàn)次數(shù)為

N1) 業(yè)務(wù)表名稱定義：描述數(shù)據(jù)庫業(yè)務(wù)表英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 業(yè)務(wù)表說明定義：數(shù)據(jù)庫業(yè)務(wù)表存儲內(nèi)容及含義的中文概要說明注解：必選項；最大出現(xiàn)次數(shù)為

13) 業(yè)務(wù)表更新頻率定義：描述數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)的更新頻率周期（天、周、月、年）注解：必選項；最大出現(xiàn)次數(shù)為

14) 業(yè)務(wù)表當(dāng)前記錄數(shù)定義：描述數(shù)據(jù)庫業(yè)務(wù)表當(dāng)前數(shù)據(jù)量，為分配前置交換區(qū)做參考依據(jù)注解：必選項；最大出現(xiàn)次數(shù)為

15) 業(yè)務(wù)表每周期更新數(shù)據(jù)量定義：描述數(shù)據(jù)庫業(yè)務(wù)表每個更新周期內(nèi)變動的數(shù)據(jù)量，為分配前置交換區(qū)做參考依據(jù)注解：必選項；最大出現(xiàn)次數(shù)為

16) 業(yè)務(wù)表數(shù)據(jù)保存周期定義：描述數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)保存周期，為分配前置交換區(qū)做參考依據(jù)注解：必選項；最大出現(xiàn)次數(shù)為

1l) 業(yè)務(wù)表字段信息

3

逐一介紹注解：必選項；最大出現(xiàn)次數(shù)為

N1) 字段名稱定義：描述業(yè)務(wù)表字段英文名稱注解：必選項；最大出現(xiàn)次數(shù)為

12) 字段描述定義：描述業(yè)務(wù)表字段含義及說明注解：必選項；最大出現(xiàn)次數(shù)為

122DB4201/T

536.2—20173) 字段類型定義：描述業(yè)務(wù)表字段存儲時對應(yīng)的數(shù)據(jù)類型注解：必選項；最大出現(xiàn)次數(shù)為

.3 定時抓取模式規(guī)范采用共享信息服務(wù)系統(tǒng)“定時抓取”各數(shù)據(jù)提供方數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)信息方式時，結(jié)合數(shù)據(jù)庫配

業(yè)務(wù)表信息、業(yè)務(wù)表字段信息，屬性具體說明參照

.2

章節(jié)中的相關(guān)描述說明。在本模式下，各業(yè)務(wù)表的“時間戳”字段和“更新記錄表”內(nèi)容由共享信息服務(wù)系統(tǒng)在抓取數(shù)據(jù)時自動賦值。.4 定時推送模式規(guī)范采用各數(shù)據(jù)提供方“定時推送”自身數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)信息至共享信息服務(wù)系統(tǒng)方式時，需各數(shù)

.2章節(jié)中的相關(guān)描述說明。在本模式下，各數(shù)據(jù)提供方推送數(shù)據(jù)至前置交換區(qū)時，需要向各業(yè)務(wù)表的“時間戳”字段和“更新記錄表”進行賦值。.5 FTP

文件上傳模式規(guī)范采用各數(shù)據(jù)提供方通過

文件上傳方式將自身數(shù)據(jù)庫業(yè)務(wù)表數(shù)據(jù)信息傳至共享信息服務(wù)系統(tǒng)參照

章節(jié)中的相關(guān)描述說明。各數(shù)據(jù)提供方將自身政務(wù)數(shù)據(jù)制作為數(shù)據(jù)文件上傳至前置交換區(qū)指定

文件服務(wù)器上，共享信各業(yè)務(wù)表的“時間戳”字段和“更新記錄表”進行賦值，上傳至

文件服務(wù)器相關(guān)文件命名及格式需要遵循以下規(guī)范：a)

CSV、EXCEL、需要擴展支持其他類型格式；b)文件命統(tǒng)一命名為：“上傳日期（YYYYMMDD）+數(shù)據(jù)庫名稱+文件名稱”。 需求方規(guī)范.1 概述基于前置數(shù)據(jù)庫交換模式，各數(shù)據(jù)提供方的相關(guān)政務(wù)數(shù)據(jù)集中存儲在前置交換區(qū)內(nèi)，因此，各數(shù)

換功能。.2 直接訪問數(shù)據(jù)庫

據(jù)，非原始業(yè)務(wù)數(shù)據(jù)，數(shù)據(jù)需求方無權(quán)查閱數(shù)據(jù)提供方的原始業(yè)務(wù)數(shù)據(jù)。.3 數(shù)據(jù)接口23DB4201/T

采用數(shù)據(jù)接口獲取數(shù)據(jù)時，共享信息服務(wù)系統(tǒng)將查詢數(shù)據(jù)功能封裝為一個對外發(fā)布的

API

數(shù)據(jù)接口，數(shù)據(jù)需求方根據(jù)授權(quán)情況，調(diào)取該數(shù)據(jù)接口，具體規(guī)范要求詳見

需求方數(shù)據(jù)接口章節(jié)描述說明。.4 FTP

文件導(dǎo)出采用

文件導(dǎo)出獲取數(shù)據(jù)時，共享信息服務(wù)系統(tǒng)將查詢出的數(shù)據(jù)組裝制作成需求方指定文件格

文件支持

CSV、EXCEL、XML

三種格式，后續(xù)可根據(jù)實際需要擴展支持其他類型格式。7 數(shù)據(jù)資源交換管理規(guī)范7.1 概述7.1.1 數(shù)據(jù)資源交換體系管理架構(gòu)包括數(shù)據(jù)資源交換體系使用和管理的三個角色和六項活動。三個角服務(wù)、使用。如圖

使用規(guī)劃服務(wù)開發(fā)

運維注冊

圖10數(shù)據(jù)資源交換體系總體管理架構(gòu)7.1.2 數(shù)據(jù)提供方、管理者、數(shù)據(jù)需求方三方共同對數(shù)據(jù)資源共享交換體系進行規(guī)劃、制定。數(shù)據(jù)提方有權(quán)查詢發(fā)布的服務(wù)接口并訪問調(diào)取相應(yīng)的政務(wù)數(shù)據(jù)資源。7.2角色職責(zé)7.2.1 數(shù)據(jù)提供方數(shù)據(jù)提供方的管理職責(zé)包括：a) 負責(zé)本部門政務(wù)數(shù)據(jù)資源共享交換服務(wù)接口建設(shè)的規(guī)劃；b) 負責(zé)開發(fā)服務(wù)接口具體實現(xiàn)功能；c) 整性、時效性；24DB4201/T

536.2—2017d)配合數(shù)據(jù)中心管理員調(diào)試服務(wù)接口功能。7.2.2 管理者管理者指數(shù)據(jù)中心管理員，其管理職責(zé)包括：a) 負責(zé)協(xié)調(diào)全市各行政主管部門完成政務(wù)數(shù)據(jù)資源共享交換服務(wù)接口建設(shè)方案；b) 為各提供方分配前置交換區(qū)；c) 對各行政主管部門的服務(wù)接口內(nèi)容審核、發(fā)布；d) 配置、調(diào)試各提供方服務(wù)接口功能；e)配合需求方調(diào)試服務(wù)接口功能；f) 提供政務(wù)數(shù)據(jù)資源的訪問、獲取服務(wù)接口。7.2.3 數(shù)據(jù)需求方數(shù)據(jù)需求方的管理職責(zé)包括：a) 負責(zé)本部門各政務(wù)數(shù)據(jù)資源共享交換需求方案的規(guī)劃；b) 訪問調(diào)取在授權(quán)范圍內(nèi)的政務(wù)數(shù)據(jù)資源，實現(xiàn)數(shù)據(jù)交換功能；c) 保證查閱數(shù)據(jù)資源的保密性和安全性，不得違規(guī)將數(shù)據(jù)提供給第三方。7.3 管理環(huán)節(jié)7.3.1 管理環(huán)節(jié)與角色關(guān)系如圖

所示，政務(wù)數(shù)據(jù)共享交換體系建設(shè)和管理各項活動與所涉及的角色關(guān)系如下：a) “規(guī)劃”環(huán)節(jié)：由數(shù)據(jù)提供方、管理者、數(shù)據(jù)需求方共同完成；b) “開發(fā)”環(huán)節(jié)：由數(shù)據(jù)提供方、數(shù)據(jù)需求方各自完成；c) “注冊”環(huán)節(jié)：由數(shù)據(jù)提供方完成；d) “運維”環(huán)節(jié)：由數(shù)據(jù)中心管理員完成；e) “服務(wù)”環(huán)節(jié)：由數(shù)據(jù)中心管理員完成；f) “使用”環(huán)節(jié)：由數(shù)據(jù)需求方完成。7.3.2 規(guī)劃規(guī)劃工作主要由數(shù)據(jù)提供方、管理者、數(shù)據(jù)需求方共同完成。該活動的主要內(nèi)容包括：a) 方案；b) 管理者協(xié)調(diào)數(shù)據(jù)提供方、數(shù)據(jù)需求方制定政務(wù)數(shù)據(jù)資源共享交換方案；c) 各數(shù)據(jù)提供方、數(shù)據(jù)需求方制定政務(wù)數(shù)據(jù)資源共享交換服務(wù)接口建設(shè)計劃。7.3.3 開發(fā)開發(fā)工作主要由數(shù)據(jù)提供方、數(shù)據(jù)需求方各自分別完成。該活動的主要內(nèi)容包括：a) 實現(xiàn)政務(wù)數(shù)據(jù)資源對外共享功能；b) 數(shù)據(jù)提供方負責(zé)相關(guān)可共享交換數(shù)據(jù)資源的更新、上報維護。7.3.4 注冊注冊工作主要由數(shù)據(jù)提供方完成。該活動的主要內(nèi)容包括：25DB4201/T

a) 數(shù)據(jù)提供方登記、注冊政務(wù)數(shù)據(jù)資源共享交換服務(wù)的接口內(nèi)容；b) 配合管理者配置、調(diào)試本部門服務(wù)接口功能。7.3.5 管理管理工作主要由管理者完成。該活動的主要內(nèi)容包括：a)為各數(shù)據(jù)提供方分配前置交換區(qū)，創(chuàng)建業(yè)務(wù)表結(jié)構(gòu)；b) 審核各數(shù)據(jù)提供方請求發(fā)布的服務(wù)接口功能；c) 配置調(diào)試各數(shù)據(jù)提供方服務(wù)接口功能；d) 審核各數(shù)據(jù)需求方對服務(wù)接口訪問調(diào)取請求，分配相關(guān)權(quán)限，保證系統(tǒng)持續(xù)運行。7.3.6 服務(wù)服務(wù)工作主要由管理者完成。該活動的主要內(nèi)容包括：a) 配合各數(shù)據(jù)需求方調(diào)試服務(wù)接口功能；b) 對外提供前置交換區(qū)數(shù)據(jù)訪問接口功能。7.3.7 使用使用工作主要由數(shù)據(jù)需求方完成。該活動的主要內(nèi)容包括：a) 查詢定位各數(shù)據(jù)提供方對外提供的服務(wù)接口；b) 通過服務(wù)接口功能獲取具體可共享政務(wù)數(shù)據(jù)資源業(yè)務(wù)信息。7.4 制度建設(shè)參照《武漢市政務(wù)數(shù)據(jù)資源共享管理暫行辦法》和《武漢市政務(wù)云平臺數(shù)據(jù)資源安全管理實施細則》中相關(guān)制度要求，保障政務(wù)服務(wù)及接口規(guī)范的持續(xù)運行，保證信息安全與系統(tǒng)持續(xù)安全服務(wù)。26政務(wù)數(shù)據(jù)共享交換申請單XXXXXXX提供方名稱服務(wù)名稱所需數(shù)據(jù)項調(diào)取說明提供方反饋意見XX數(shù)據(jù)需求方填表時間聯(lián)系人電話DB4201/T

536.2—2017附 錄 A（資料性附錄）政務(wù)共享交換服務(wù)表單示例A.1 政務(wù)數(shù)據(jù)共享交換申請單示例政務(wù)數(shù)據(jù)共享交換申請單示例如表所示。表A.1 表A.1 政務(wù)數(shù)據(jù)共享交換申請單示例政務(wù)數(shù)據(jù)共享交換確認單XXXXXXXX-XX-XXXXXX-XX-XX數(shù)據(jù)需求部門數(shù)據(jù)提供部門市網(wǎng)信辦審核意見：DB4201/T

A.2 政務(wù)數(shù)據(jù)共享交換確認單示例政務(wù)數(shù)據(jù)共享交換確認單示例如表所示。表A.2表A.2政務(wù)數(shù)據(jù)共享交換確認單示例提供方數(shù)據(jù)接口參數(shù)示例接口名稱：getXxByIDCard接口版本號：X.X接口描述：

XX

接口類型：webservice返回報文類型：xml訪問地址：http://WebServices/ValidateEmailWebService.asmx?wsdl訪問帳號：XXXXX訪問密碼：XXXXXX提供方名稱：XXX技術(shù)聯(lián)系人：XX聯(lián)系人電話：XXXXXXXXXXX請求參數(shù)名稱類型數(shù)據(jù)長度是否必須默認值描述ID_cardString18

響應(yīng)參數(shù)名稱類型數(shù)據(jù)長度示例值描述NameString50XXPhoneString20XXXXXXXXXXX錯誤結(jié)果參數(shù)名稱類型數(shù)據(jù)長度示例值描述CodeString50MsgString30Remote

serviceerrorsub_msgString100錯誤代碼定義DB4201/T

536.2—2017B附

錄 B（資料性附錄）數(shù)據(jù)接口參數(shù)示例B.1 提供方數(shù)據(jù)接口參數(shù)示例表提供方數(shù)據(jù)接口參數(shù)示例如表所示。表B.1表B.1提供方數(shù)據(jù)接口參數(shù)示例表錯誤代碼錯誤消息錯誤說明50Remote

service

error30illegal

20illegal

請求示例XML

<user_buyer_get_response>

</user_buyer_get_response>響應(yīng)示例XML

<user_buyer_get_response>

</user_buyer_get_response>錯誤結(jié)果示例XML

<error_response>

</sub_msg></error_response>DB4201/T

表

B.1提供方數(shù)據(jù)接口參數(shù)示例表（續(xù)）30提供方數(shù)據(jù)接口參數(shù)示例接口名稱：getPersonByIDCard接口版本號：X.X接口描述：

XX

接口類型：webservice返回報文類型：xml訪問地址：http://localhost:9099/api/ws/rest技術(shù)聯(lián)系人：XX聯(lián)系人電話：XXXXXXXXXXX公共請求參數(shù)名稱類型數(shù)據(jù)長度是否必須默認值描述methodString20api_keyString50

timestampString10

yyyy-MM-ddHH:mm:ss

String1.0signString2048請求參數(shù)名稱類型數(shù)據(jù)長度是否必須默認值描述ID_cardString18

響應(yīng)參數(shù)名稱類型數(shù)據(jù)長度示例值描述NameString50XXPhoneString20XXXXXXXXXXX錯誤結(jié)果參數(shù)名稱類型數(shù)據(jù)長度示例值描述codeString50msgString30Remote

serviceerrorsub_msgString100DB4201/T

536.2—2017B.2 調(diào)取所需數(shù)據(jù)接口參數(shù)示例表調(diào)取所需數(shù)據(jù)接口參數(shù)示例如表B.2所示。表B.2 表B.2 調(diào)取所需數(shù)據(jù)接口參數(shù)示例表錯誤代碼定義錯誤代碼錯誤消息錯誤說明50Remote

service

error30illegal

20illegal

請求示例XML

<user_buyer_get_response>

</user_buyer_get_response>響應(yīng)示例XML

<user_buyer_get_response>

</user_buyer_get_response>錯誤結(jié)果示例XML

<error_response>

</sub_msg></error_response>DB4201/T

表

表

B.2 調(diào)取所需數(shù)據(jù)接口參數(shù)示例表（續(xù)）數(shù)據(jù)庫配置參數(shù)示例提供方名稱：XXX數(shù)據(jù)庫名稱：db_person數(shù)據(jù)庫類型：Oracle數(shù)據(jù)庫

IP

XXX.XXX.XXX.XXX端口：XXXX數(shù)據(jù)庫

MAC

XXX.XXX.XXX.XXX用戶名：XXXXX密碼：XXXXXX技術(shù)聯(lián)系人：XX聯(lián)系人電話：XXXXXXXXXXX業(yè)務(wù)表信息名稱說明更新頻率當(dāng)前記錄數(shù)每周期更新數(shù)據(jù)量數(shù)據(jù)保存周期person