智慧城公共信息平臺(tái)平臺(tái)接口與服務(wù)要求

1、智慧城市公共信息平臺(tái)平臺(tái)接口與服務(wù)要求1范圍本要求 是智慧城市公共信息平臺(tái)建設(shè)指南建設(shè)要求系列之接口與服接口與服 接口與服務(wù)要求。本部分 要求 分兩大部描述平臺(tái)接口分兩大部描述平臺(tái)接口分兩大部描述平臺(tái)接口分兩大部描述平臺(tái)接口分兩大部描述平臺(tái)接口要求，第一部分：總體 ，第一部分：總體，第一部分：總體，第一部分：總體 要求，總體 要求 描述消息的總體結(jié)構(gòu)、接口訪問方地址使用說明。第二部分：業(yè)務(wù)描述消息的總體結(jié)構(gòu)、接口訪問方地址使用說明。第二部分：業(yè)務(wù) 描述消息的總體結(jié)構(gòu)、接口訪問方地址使用說明。第二部分：業(yè)務(wù) 描述 消息的總體結(jié)構(gòu)、 接口訪問方地址使用說明。第二部分：業(yè)務(wù) 描述消息的總體結(jié)構(gòu)、 接

2、口訪問方地址使用說明。第二部分：業(yè)務(wù)描述消息的總體結(jié)構(gòu)、接口訪問方地址使用說明。第二部分：業(yè)務(wù) 接口要求，具體描述每個(gè)業(yè)務(wù)應(yīng)用服接口的，具體描述每個(gè)業(yè)務(wù)應(yīng)用服接口的 要求。也就是每一個(gè)業(yè)務(wù)接口。也就是每一個(gè)業(yè)務(wù)接口要求 套在總體 要求內(nèi)。只有使用業(yè)務(wù)接口內(nèi)。只有使用業(yè)務(wù)接口內(nèi)。只有使用業(yè)務(wù)接口內(nèi)。只有使用業(yè)務(wù)接口要求+總體 要求 才能正常使用信息平臺(tái)的應(yīng)才能正常使用信息平臺(tái)的應(yīng)才能正常使用信息平臺(tái)的應(yīng)才能正常使用信息平臺(tái)的應(yīng)用服務(wù)來發(fā)現(xiàn)，查詢管理資源。本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)

3、設(shè)計(jì)和研 發(fā)人員，系統(tǒng)維護(hù)及要求 本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研 發(fā)人員，系統(tǒng)維護(hù)及要求 本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研 發(fā)人員，系統(tǒng)維護(hù)及要求 本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研發(fā)人員，系統(tǒng)維護(hù)及要求本部分適用于參與公共信息平臺(tái)設(shè)計(jì)和研

4、發(fā)人員，系統(tǒng)維護(hù)及要求接入公共信息平臺(tái)的外部應(yīng)用開發(fā)人員。 智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求22規(guī)范性引用文件 下列文件中的條款通過本部分引用而成為。凡是注日期下列文件中的條款通過本部分引用而成為。凡是注日期用文件，其隨后 用文件，其隨后 所有的修改單（不包括勘誤內(nèi)容）或訂版均適用于本部分，所有的修改單（不包括勘誤內(nèi)容）或訂版均適用于本部分，所有的修改單（不包括勘誤內(nèi)容）或訂版均適用于本部分，鼓勵(lì)根據(jù)本部分達(dá)成協(xié)議的各方研究是否可使用這些文件最新版。凡不注鼓勵(lì)根據(jù)本部分達(dá)成協(xié)議的各方研究是否可使用 這些文件最新版。凡不注日期的引用文件，其最新版本適于部分。GB/T 21063.1 -2

5、007政務(wù)信息資源目錄體系第1部分：總體框架；GB/T 21063.2 -2007政務(wù)信息資源目錄體系第2部分：技術(shù)要求；GB/T 21063.3 -2007政務(wù)信息資源目錄體系第3部分：核心元數(shù)據(jù)；GB/T 21063.4 GB/T 21063.4 -2007政務(wù)信息資源目錄體系第4部分：政務(wù)信息資源分類；GB/T 21063.5 -2007政務(wù)信息資源目錄體系第5部分：政務(wù)信息資源標(biāo)識(shí)部分：政務(wù)信息資源標(biāo)識(shí)符編碼方案；本文業(yè)務(wù)接口 要求引用GB/T 21063.2 GB/T 21063.2 -2007中的附錄A目錄服務(wù)接口；本文附錄A要求所涉及的結(jié)構(gòu)表所涉及的結(jié)構(gòu)表所涉及的結(jié)構(gòu)表所涉及的結(jié)

6、 構(gòu)表引用引用GB/T 21063.2 GB/T 21063.2 -2007中的附 中的附 中的附 錄A目錄服務(wù)接口，及引用 目錄服務(wù)接口，及引用 目錄服務(wù)接口，及引用GB/T21063.2 GB/T 21063.2 -2007中的附錄 中的附錄C政務(wù)信息資源目 錄服務(wù)屬性集本文附錄D QUERY D QUERY -RPN范例引用 GB/T 21063.2GB/T 21063.2 -2007中的附錄 中的附錄F檢 索串示例9.智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求33術(shù)語與定義GB/T 19710 -2005中規(guī)定的與以下術(shù)語和義適用于本部分。目錄針對(duì)擁有共性的數(shù)據(jù)資源針對(duì)擁有共性的數(shù)據(jù)資源

7、針對(duì)擁有共性的數(shù)據(jù)資源針對(duì)擁有共性的數(shù)據(jù)資源 /文件資源進(jìn)行分類，并且為該賦予唯一的文件資源進(jìn)行分類，并且為該賦予唯一的文件資 源進(jìn)行分類，并且為該賦予唯一的文件資源進(jìn)行分類，并且為該賦予唯一的文件資 源進(jìn)行分類，并且為該賦予唯一的文件資源進(jìn)行分類，并且為該賦予唯一的文件資源進(jìn)行分類，并且為該賦予唯一的源標(biāo)識(shí)符，該部分類及描述的集合統(tǒng)稱為資 目錄簡(jiǎn)。結(jié)構(gòu)化資源公共信息平臺(tái)享的二維庫表結(jié)構(gòu)數(shù)據(jù)，統(tǒng)稱為化資源。非結(jié)構(gòu)化資源公共信息平臺(tái)享的非二維庫表結(jié)構(gòu)數(shù)據(jù)，例如：文本件、視頻網(wǎng)絡(luò)訪 公共信息平臺(tái)享的非二維庫表結(jié)構(gòu)數(shù)據(jù)，例如：文本件、視頻網(wǎng)絡(luò)訪公共信息平臺(tái)享的非二維庫表結(jié)構(gòu)數(shù)據(jù)，例如：文本件、視頻網(wǎng)

8、絡(luò)訪公共信息平臺(tái)享的非二維庫表結(jié)構(gòu)數(shù)據(jù)，例如：文本件、視頻網(wǎng)絡(luò)訪公共信息平臺(tái)享的非二維庫表結(jié)構(gòu)數(shù)據(jù)，例如：文本件、視頻網(wǎng)絡(luò)訪問資源等統(tǒng)稱為非結(jié)構(gòu)化。 數(shù)據(jù)交換管理者管理信息資源結(jié)點(diǎn)的機(jī)構(gòu)。交換內(nèi)容提供者提供信息資源交換內(nèi)容的機(jī)構(gòu)。交換內(nèi)容使用者使用信息資源交換內(nèi)容的機(jī)構(gòu)。前置環(huán)境應(yīng)用單 位接入端系統(tǒng)軟硬件及相關(guān)網(wǎng)絡(luò)環(huán)境組成的前置元環(huán)境。目錄交換按訂閱模式進(jìn)行目錄資源數(shù)據(jù)的交換；橋接系統(tǒng)業(yè)務(wù)數(shù)據(jù)庫與共享的橋接器，保持 交換 數(shù)據(jù)庫與共享的同步 數(shù)據(jù)庫與共享的同步 數(shù)據(jù) 庫與共享的同步 數(shù)據(jù)庫與共享的同步 數(shù)據(jù)庫與共享的同步 數(shù)據(jù)庫與共享的同步 數(shù)據(jù)庫 與共享的同步 數(shù)據(jù)庫與共享的同步 數(shù)據(jù)庫與共

9、享的同步 數(shù)據(jù)庫與共享的同步 ；變更捕捉捕捉數(shù)據(jù)資源變更情況。數(shù)據(jù)轉(zhuǎn)入以固定間隔時(shí)輪詢變更登記表，讀取其中的錄并將這些約以固定間隔時(shí)輪詢變更登記表，讀取其中的 錄并將這些約以固定間隔時(shí)輪詢變更登記表，讀取其中的錄并將這些約格式組成XML報(bào)文，存儲(chǔ)到共享庫的換出表中；非結(jié)構(gòu)化數(shù)據(jù)文件直接通過服務(wù)傳輸至交換中心器， 并有非結(jié)構(gòu)化數(shù)據(jù)文件直接通過服務(wù)傳輸至交換中心器，并有智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求4分發(fā)非結(jié)構(gòu)化數(shù)據(jù)文件。數(shù)據(jù)交換路由以固定時(shí)間隔輪詢應(yīng)用單位換入表，拆解以固定時(shí)間隔輪詢應(yīng)用單位換入表，拆解XML報(bào)文，根據(jù)目標(biāo)庫自動(dòng)分揀報(bào)文，根據(jù)目標(biāo)庫自動(dòng)分揀；非結(jié)構(gòu)化數(shù)據(jù)文件直接通過服務(wù)

10、傳輸至交換中心器， 并有非結(jié)構(gòu)化數(shù)據(jù)文件直接通過服務(wù)傳輸至交換中心 器，并有分發(fā)非結(jié)構(gòu)化數(shù)據(jù)文件。數(shù)據(jù)轉(zhuǎn)出獨(dú)立運(yùn)行的進(jìn)程，以固定間隔時(shí)輪詢交換庫中的入表， 讀取其以固定間隔時(shí)輪詢交換庫中的 入表，讀取其XML報(bào)文，并將數(shù)據(jù)按定制的格式同步到共享庫中。非結(jié)構(gòu)化數(shù)據(jù)文件描述信息存儲(chǔ)在隊(duì)列中，由各服務(wù)器根分非結(jié)構(gòu)化數(shù)據(jù)文件描述信息存儲(chǔ)在隊(duì)列中，由各服務(wù)器根分別從中心文件服務(wù)器獲取所需數(shù)據(jù)。交換管理程序完成數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理數(shù)據(jù) 交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理 數(shù)據(jù)交換審批流程、監(jiān)控調(diào)

11、度系統(tǒng)管理數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理數(shù)據(jù)交換審批流程、監(jiān)控調(diào)度系統(tǒng)管理等功能一套等功能一套程序，部署于中心。Web服務(wù)基于webservice技術(shù)開放的 服務(wù)接口，采用約定的服務(wù)接口，采用約定的XML作為交易數(shù)據(jù)接口，提供給客戶端調(diào)用。WSDLWeb服務(wù)描述文件，一個(gè)用來描述一個(gè)用來描述Web服務(wù)和說明如何與 服務(wù)和說明如何與Web服務(wù)通信的 服務(wù)通信的XML語言。為用戶提供詳細(xì)的接口說明。訪問認(rèn)證公共信息平臺(tái)提供用戶認(rèn)證服務(wù)， 由托管應(yīng)系統(tǒng)的客端調(diào)于驗(yàn)公共信息平臺(tái)提供用戶認(rèn)證服務(wù)，由托管應(yīng)系統(tǒng)的客端調(diào)于驗(yàn)公共信息平臺(tái)提供用戶認(rèn)證服務(wù)，由托管應(yīng)系統(tǒng)的客端調(diào)于驗(yàn)用戶是否合法； 應(yīng)用單位接

12、入公共信息平臺(tái)的機(jī)構(gòu)單位。主管單位公共信息平臺(tái)的管理單位 。數(shù)據(jù)中心公共 信息平臺(tái) 的組成部分，是公共信息平臺(tái)數(shù)據(jù)及應(yīng)用系統(tǒng)存儲(chǔ)的地方。智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求54接口服務(wù)概述4.1接口服務(wù)組成信息資源目錄服務(wù)包含三種接口，即信息資源基礎(chǔ)服務(wù)接口、資源服務(wù)接口（發(fā)現(xiàn)接口、資源接口 ）、信息資源管理服務(wù)接口。其中，基礎(chǔ)接口是將資源服務(wù)接口和管理接口中基礎(chǔ)性的操作定義成一個(gè)公共接口。這3類接口實(shí)現(xiàn)了信息資源的發(fā)現(xiàn)功能、檢索功能和管理功能?；A(chǔ)接口：提供會(huì)話管理功能和服務(wù)自描述功能，包含有目錄服務(wù)初始化接口、目錄服務(wù)終止接口和服務(wù)自描述接口。發(fā)現(xiàn)接口 ：提供信息資源元數(shù)據(jù)檢索功能和信

13、息資源元數(shù)據(jù)檢索結(jié)果提取功 能，包含有目錄檢索接口以及目錄檢索結(jié)果提取接口。這些接口本身并不提供資 源，而是提供資源基本信息和如何去獲得這些資源的元數(shù)據(jù)。資源接口：根據(jù)發(fā)現(xiàn)接口獲得信息資源元數(shù)據(jù)，定位、查找資源具體內(nèi)容的接口，包含資源內(nèi)容檢索接口及資源內(nèi)容結(jié)果提取接口。管理接口：提供元數(shù)據(jù)管理的功能，包含信息資源元數(shù)據(jù)管理接口。城市公共信息平臺(tái)接口服務(wù)組成見圖1.智慧城市公共信息平臺(tái)基礎(chǔ)接口服務(wù)資源接口服務(wù)管理接口服務(wù)服務(wù)初始化認(rèn)證授權(quán)服務(wù)終止發(fā)現(xiàn)服務(wù)資源服務(wù)資源元數(shù)據(jù)新增服務(wù)資源元數(shù)據(jù)更新服務(wù)資源元數(shù)據(jù)刪除服務(wù)資源目錄檢索資源目錄結(jié)果提取資源內(nèi)容檢索資源內(nèi)容結(jié)果提取圖1.城市公共信息平臺(tái)接口

14、服務(wù)組成圖智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求64.2 4.2接口技術(shù)要求 接口技術(shù)要求 接口技術(shù)要求 接口技術(shù)要求 接口技術(shù)要求a）提供基于SOAP協(xié)議的web服務(wù)接口b）支持跨語言、操作系統(tǒng)調(diào)用智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求75總體要求5. 1消息結(jié)構(gòu)每個(gè)交易消息每個(gè)交易消息（包括請(qǐng)求和應(yīng)答包括請(qǐng)求和應(yīng)答包括請(qǐng)求和應(yīng)答包括請(qǐng) 求和應(yīng)答）有一個(gè)是名字（有一個(gè)是名字（有一個(gè)是名字（有一個(gè)是名字（MessageName Message Name）,交易消息），交易消息），交易消息 以XML格式表達(dá)的，根據(jù)格式表達(dá)的，根據(jù)XML的定義，每個(gè) 的定義，每個(gè)XML文件需要有特定的Root

15、 TagRoot Tag（根標(biāo)記），在本 標(biāo)記），在本 標(biāo)記），在本 要求中，用交易名稱中，用交易名稱+請(qǐng)求類別作為根節(jié)點(diǎn)，如初始化接口的包請(qǐng)求類別作為根節(jié)點(diǎn)，如初始化接口的包根節(jié)點(diǎn)為initRequest，而響應(yīng)包的根節(jié)點(diǎn)為，而響應(yīng)包的根節(jié)點(diǎn)為initResponse。根節(jié)點(diǎn)下之間放業(yè)。根節(jié)點(diǎn)下之間放業(yè)務(wù)接口數(shù)據(jù)。5.1.1請(qǐng)求報(bào)文范例 5.1.2響 應(yīng) 報(bào) 文 范 例 5.2 5.2接口方式接口采用WebService方式，接口協(xié)議使用SOAP協(xié)議，提供標(biāo)準(zhǔn)的WSDL文 件。智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求85.3 5.3接口地址公共信息目錄服務(wù)（以下簡(jiǎn)稱）主要有三個(gè)公共信息目錄服

16、務(wù)（以下簡(jiǎn)稱）主要有三個(gè)公共信息目錄服務(wù)（以下簡(jiǎn)稱）主要有三個(gè)wsdl地址，不同的 地址，不同的wsdl下有不同的方法，文說明。這是根據(jù)webservice的soap協(xié)議開放出來的協(xié)議開放出來的wsdl地址，第三方應(yīng)用可以根據(jù)實(shí)際的部署服務(wù)器來使它。1）基礎(chǔ)接口WSDL文件地址：http:/:/es/catalogbase?wsdl目錄服務(wù)初始化-initCatalogService目錄服務(wù)終止-stopCatalogService2）發(fā)現(xiàn)接口WSDL文件地址：http:/:/es/digcatalog?wsdl目錄檢索-queryCatalogList目錄檢索結(jié)果提取-queryCatalo

17、gResult3）資源服務(wù)接口：http:/:/es/digresource?wsdl資源檢索-getResourceResultset資源檢索結(jié)果提取-getResourceResultDetail4）發(fā)現(xiàn)接口WSDL文件地址：http:/:/es/digcatalog?wsdl資源元數(shù)據(jù)管理-metadataManage5.4 5.4使用說明完成資源的檢索與發(fā)現(xiàn)需要根據(jù)以下步驟來操作：1）第一步：初始化操作。調(diào)用基礎(chǔ)接口的“目錄服務(wù)初始化”獲得一個(gè)會(huì)話標(biāo)識(shí)符以后每次調(diào)用接口都需要次標(biāo)識(shí)符。2）第二步：查詢公共信息目錄操作。調(diào)用發(fā)現(xiàn)接口的“目錄檢索”組織好查詢參數(shù)，發(fā)起交易，獲得查詢結(jié)果。注

18、：這里的查詢結(jié)果只有返回命中的查詢記錄數(shù)。比如：返回值是100,那么表示有100條記錄符合查詢條件，這個(gè)時(shí)候需要發(fā)起“公共信息目錄檢索結(jié)果提 取”交易才能提取智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求9查詢的結(jié)果。如果發(fā)回值是0,表示沒有符合查詢條件的記錄。3）第三步：查詢公共信息目錄對(duì)應(yīng)的資源。這里的操作也是和上面一樣，調(diào)用“資源檢索”先要查詢下是否有符合查詢條件的資源。有資源記錄的話，然后在調(diào)用“資源檢索結(jié)果提取”提取符合條件的資源信息。4）第四步：假如調(diào)用接口結(jié)束后，可調(diào)用基礎(chǔ)接口里的“目錄服務(wù)終止”來釋放會(huì)話標(biāo)識(shí) 符資源信息。智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求106業(yè)務(wù)接口要求6.

19、1 6.1基礎(chǔ)接口 要求6.1.1目錄服務(wù)初始化公共信息目錄服務(wù)初始化用于建立客戶端與服務(wù)端的會(huì)話，所有其他服務(wù)都必須依賴會(huì)話。會(huì)話的持續(xù)時(shí)間為30分鐘，若會(huì)話持續(xù)30分鐘沒有活動(dòng)，則會(huì)話自動(dòng)終止。本次初始化 作用是客戶端認(rèn)證同時(shí)獲取會(huì)話標(biāo)識(shí)符，后續(xù)發(fā)起交易時(shí)需要傳遞該會(huì)話標(biāo)識(shí)符。1.請(qǐng)求報(bào)文體 序號(hào) 元素名稱 元素名稱 約束 類型 長(zhǎng)度描述 取值說明 取值說明1.protocolversionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVer

20、sionprotocolVersionprotocolVersionprotocolVersionprotocolVersion可選StringStringStringString String50客戶端協(xié)議版本號(hào)客戶端協(xié)議實(shí)現(xiàn)的 客戶端協(xié)議實(shí)現(xiàn)的 客戶端協(xié)議實(shí)現(xiàn)的 客戶端協(xié)議實(shí)現(xiàn)的 客戶端協(xié)議 實(shí)現(xiàn)的 客戶端協(xié)議實(shí)現(xiàn)的客 戶 端 協(xié) 議 實(shí) 現(xiàn) 的客戶端協(xié)議實(shí)現(xiàn)的版本號(hào)2.idAuthentication idAuthentication idAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthenticat

21、ionidAuthentication idAuthentication必選StringStringStringString String 50用戶名用戶名用戶名/密碼認(rèn)證信息。包含用戶 認(rèn)證信息。包含用戶 認(rèn)證信息。包含用戶 認(rèn)證信息。包含用戶 認(rèn) 證信息。包含用戶 認(rèn)證信息。包含用戶 身份標(biāo)識(shí)及其密碼。身 份標(biāo)識(shí)及其密碼。身份標(biāo)識(shí)及其密碼。身份標(biāo)識(shí)及其密碼。 身份標(biāo)識(shí)及其密碼。 格式“格式用戶名 用戶名/密碼”3.implementationIdimplementationIdimplementationIdimplementationIdimplementationIdimplement

22、ationIdimplementationIdimplementationIdimplementationId可選StringStringStringString String50應(yīng)用標(biāo)識(shí)應(yīng)用標(biāo)識(shí)在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息 平臺(tái)用 在公共信息平臺(tái)用 在公共信息平臺(tái)用在公共信息平臺(tái)用戶體系中注冊(cè)的第戶體系中注冊(cè)的第戶體系中注冊(cè)的第戶體系中注冊(cè)的第戶體系中注冊(cè)的第戶體系中注冊(cè) 的第戶體系中注冊(cè)的第戶體系中注冊(cè)的第三方應(yīng)用編號(hào)三方應(yīng)用編號(hào)三方應(yīng)用編號(hào)4.implementationNameimplementationNameimplementation

23、NameimplementationNameimplementationNameimplementationNameimplementationName implementationName implementationName可選StringStringStringString String200200200應(yīng)用名稱應(yīng)用名稱在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息平臺(tái)用在公共信息 平臺(tái)用 在公共信息平臺(tái)用 在公共信息平臺(tái)用 在公共信息平臺(tái)用 戶管系統(tǒng)中注冊(cè)的 戶 管系統(tǒng)中注冊(cè)的 戶管系統(tǒng)中注冊(cè)的 戶管系統(tǒng)中注冊(cè)的 戶管系統(tǒng)中注冊(cè)的 戶管系統(tǒng)中注 冊(cè)的戶管系統(tǒng)中注冊(cè)的 戶管系

24、統(tǒng)中注冊(cè)的 第三方應(yīng)用名稱第三方應(yīng)用名稱第三方應(yīng) 用名稱5.otherInfootherInfootherInfo otherInfo otherInfootherInfo可選element element其他信息其他信息備用2.請(qǐng)求報(bào)文體模板V1.0testApp/124561 測(cè)試應(yīng)用 3.響應(yīng)報(bào)文體智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求11序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceId referenceId必選StringStringStringString String 50會(huì)話標(biāo)識(shí)會(huì)

25、話標(biāo)識(shí)當(dāng)驗(yàn)證成功時(shí)返回，否 當(dāng)驗(yàn)證成功時(shí)返回，否 當(dāng)驗(yàn)證成功時(shí)返回，否 當(dāng)驗(yàn)證成功時(shí)返回，否 當(dāng)驗(yàn)證成功時(shí)返回，否則設(shè)置為空 則設(shè)置為空2.protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion必選StringStringStringString String 50服務(wù)端協(xié)議版本號(hào)服務(wù)端協(xié)議實(shí)

26、現(xiàn)的版本 服務(wù)端協(xié)議實(shí)現(xiàn)的版本 服務(wù)端協(xié)議實(shí)現(xiàn)的版本服務(wù)端協(xié)議實(shí)現(xiàn)的版本服務(wù)端協(xié)議實(shí)現(xiàn)的版本 服務(wù)端協(xié)議實(shí)現(xiàn)的版本 服務(wù)端協(xié)議實(shí)現(xiàn)的版本 服務(wù)端協(xié) 議實(shí)現(xiàn)的版本服務(wù)端協(xié)議實(shí)現(xiàn)的版本 服務(wù)端協(xié)議實(shí)現(xiàn)的版本 號(hào)3.resultresult result必選Boolean Boolean處理結(jié)果處理結(jié)果服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明 服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明服務(wù)器端用該參數(shù)表明是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)

27、是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)是否接受建立會(huì)話的請(qǐng)求。truetruetrue表示建立會(huì)話成功，falsefalsefalsefalse表示建立會(huì) 表示建立會(huì) 話失敗，此時(shí)話失敗，此時(shí)話失敗，此時(shí) 話失敗，仕匕時(shí)referenceldreferenceldreferenceldreferenceldreferenceldreferenceld為空。4.pubKey pubKey pubKeypubKey必選StringStringStringString String 64加解密公鑰加解密公鑰5.otherlnfootherlnfootherl

28、nfo otherlnfo otherlnfootherlnfo可選element element其他信息其他信息 備用4.響 應(yīng) 報(bào) 文 體 模 板cde2db52-8cee-45f4-9cec-f8a68ebbad5cV1.0catalogtrue初 始 化 服 務(wù) 成 功 6.1.2目錄服務(wù)終止 公共信息目錄服務(wù)終止將結(jié)束服務(wù)端與客戶端的會(huì)話，與會(huì)話相關(guān)的資源將被釋放。1.請(qǐng)求報(bào)文體 序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.referenceldreferenceldreferenceldreferenceld referenceld必選StringStringStrin

29、gString String 50會(huì)話標(biāo)識(shí)會(huì)話標(biāo)識(shí)要終止的會(huì)話編號(hào)要終止的會(huì)話編號(hào)要終止的會(huì)話編號(hào)要終止的會(huì)話編號(hào)2.closeReasoncloseReasoncloseReasoncloseReasoncloseReasoncloseReasoncloseReason可選StringStringStringString String 50終止原因終止原因3.otherlnfootherlnfootherlnfo otherlnfo otherlnfootherlnfo可選element element其他信息其他信息 備用2.求 報(bào) 文 體 模 板cde2db52-8cee-45f4-9c

30、ec-f8a68ebbad5c智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求12終止使用 6.1.3認(rèn)證授權(quán)認(rèn)證授權(quán)主要是公鑰獲取接口服務(wù)，用于根據(jù)客戶端應(yīng)用的請(qǐng)求，取出最新的加解密公鑰并返回給客戶端的過程。公鑰獲取與其他接口不同，不需要用戶驗(yàn)證，不需要會(huì)話標(biāo)識(shí)。調(diào)用客戶端只有獲取公鑰后對(duì)用戶認(rèn)證信息進(jìn)行加密才能完成其服務(wù)調(diào)用。整個(gè)密碼加解密的處理過程如下圖所示：圖2.密碼加解密的處理過程圖1.請(qǐng)求報(bào)文體序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.otherInfootherInfootherInfo otherInfo otherInfootherInfo可選element eleme

31、nt其他信息備用2.請(qǐng)求報(bào)文體模板智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求13 3.響應(yīng)報(bào)文體序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.pubKey pubKey pubKeypubKey必選StringStringStringString String8公鑰用于加解密碼的密鑰2.opResultopResult opResult opResult必選element element操作結(jié)果參見表 參見表 參見表 參見表A.6A.6A.6 opResultopResult opResultopResult屬 性表之 屬性表之 屬性表之 說明3.otherInfootherInfoo

32、therInfo otherInfo otherInfootherInfo可選element element其他信息備用4.響 應(yīng)報(bào)文 體模板 catalog true codemessage 6.2 6.2發(fā)現(xiàn)接口要求6.2.1資源目錄檢索公共信息目錄檢索是服務(wù)端根據(jù)客戶端指定的檢索條件，在服務(wù)器端從元數(shù)據(jù)庫中檢索并 標(biāo)識(shí)出匹配的元數(shù)據(jù)記錄，并將元數(shù)據(jù)記錄保存在結(jié)果集中的過程。結(jié)果集的保存時(shí)間與會(huì)話標(biāo)識(shí)一致，當(dāng)會(huì)話結(jié)束后，響應(yīng)的結(jié)果集將被同步刪除。智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求141.請(qǐng)求報(bào)文體序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.referenceldrefer

33、enceldreferenceldreferenceld referenceld必選StringStringStringString String 50會(huì)話標(biāo)識(shí)會(huì)話標(biāo)識(shí)2.replacelndicatoreplacelndicato replacelndicato replacelndicatoreplacelndicato replacelndicatoreplacelndicatoreplacelndicator必選Boolean Boolean結(jié)果集覆蓋結(jié)果集覆蓋結(jié)果集覆蓋結(jié)果集覆蓋結(jié)果集覆蓋標(biāo)志truetruetrue表示覆蓋原來的查表示覆蓋原來的查 表示覆蓋原來的查表示覆蓋原來的查表

34、示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查詢結(jié)果，詢結(jié)果，falsefalse falsefalse表示保留表示保留原來的查詢結(jié)果原來的查詢結(jié)果原來 的查詢結(jié)果3.resultSetlDresultSetlD resultSetlD resultSetlDresultSetlD resultSetlD必選StringStringStringString String 200200200指定的查詢指定的查詢指定的查詢指定的查詢指定的查詢結(jié)果集名稱結(jié)果集名稱若存在同名的結(jié)果集，若存在同名的結(jié)果集，若存在同名的結(jié)果集，若存在同名的結(jié)果集，若存在同名的結(jié)果集，需要根據(jù) 需要根據(jù)re

35、placelndicatorreplacelndicatorreplacelndicatorreplacelndicatorreplacelndicatorreplacelndicatorreplacelndicatorreplacelndicatorreplacelndicator判斷是 判斷是 否需要覆蓋 結(jié)果集。否需要覆蓋結(jié)果集。 否需要覆蓋結(jié)果集。否需要覆蓋結(jié)果集。4.databaseName databaseNamedatabaseName databaseName databaseNamedatabaseName databaseNames必選Element Element Ele

36、ment要查詢的元要查詢的元要查詢的元要查詢的元要查詢的元數(shù)據(jù)庫名稱數(shù)據(jù)庫名稱數(shù)據(jù)庫名稱數(shù)據(jù)庫名稱數(shù)據(jù)庫名稱列表客戶端指定的要查詢?cè)獢?shù)據(jù)庫名稱列表元數(shù)據(jù)庫名稱列表元數(shù)據(jù)庫名稱列表元數(shù)據(jù)庫名稱列表5.query query query必選Element Element Element客戶端定制 客戶端定制 客戶端定制 客戶端定制 客戶端定制 的檢索語句 的檢索語句 檢索語句必須符合檢索語句必須符合 檢索語句必須符合 檢索語句必須符合TypeType-1型，使用逆波蘭 型，使用逆波蘭 型，使用逆波蘭 型，使用逆波蘭 表達(dá)式(RPN)(RPN) (RPN)作為檢索語 作為檢索語 作為檢索語 法，參見

37、附錄 法，參見附錄法，參見附錄 法，參見附錄E QUERY QUERY QUERY-RPN RPN范例 范例6.preferredRecor preferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecor preferredRecorpreferredRecorpreferredRecordSyntax dSyntax dSyntaxdSyntaxdSyntax可選StringStringStringString String 10檢索結(jié)果的 檢索結(jié)果的 檢索結(jié)果的 檢索結(jié)果的 檢索結(jié)果的 編碼方式 編碼方式 固定取

38、值 固定取值： ” XML ”： ” XML ” ： ”XML ” ：” XML ” ：” XML ”7.otherInfootherInfootherInfo otherInfo otherInfootherInfo可選Element Element Element其他信息其他信息 備用2.請(qǐng) 求 報(bào) 文 體 模 板f4973365-a9be-4f80-b5d8-a8b9c7949185truehighResultBMDBXML根據(jù)國(guó)標(biāo)的逆波蘭表達(dá)式(RPN)組合的查詢條件，具體規(guī)則參考附錄E QUERY E QUERYEQUERYE QUERY-RPNRPN范例范例 3.響應(yīng)報(bào)文體序號(hào)元素

39、名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceId referenceId必選StringStringStringString String 50會(huì)話標(biāo)識(shí)會(huì)話標(biāo)識(shí)智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求152.resultCountresultCount resultCount resultCount resultCount resultCount必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberSt

40、ringNumberString 20符合條件符合條件符合條件符合條件的記錄數(shù)的記錄數(shù) 服務(wù)器端執(zhí)行檢索操作得服務(wù)器端執(zhí)行檢索操作得服務(wù)器端執(zhí)行檢索操作得服務(wù)器端執(zhí)行檢索操作得服務(wù)器端執(zhí)行檢索操作得到的命中記錄數(shù)，檢索失敗到的命中記錄數(shù)，檢索失敗 到的命中記錄數(shù)，檢索失敗 到的命中記錄數(shù)，檢索失敗 到的命中記錄數(shù)，檢索 失敗 到的命中記錄數(shù)，檢索失敗到的命中記錄數(shù)，檢索失敗設(shè)置為 設(shè)置為03.searchStatussearchStatussearchstatussearchStatussearchStatussearchStatussearchStatussearchStatus必選Stri

41、ngStringStringString String7執(zhí)行檢索執(zhí)行檢索執(zhí)行檢索執(zhí)行檢索的執(zhí)行結(jié)的執(zhí)行結(jié)的執(zhí)行結(jié)的執(zhí)行結(jié)果 返回的檢索狀態(tài)信息，返回的檢索狀態(tài)信息，返回的檢索狀態(tài)信息，返回的檢索狀態(tài)信息，返回的檢索狀態(tài)信息，successsuccess success success示檢索成功，表示檢索成功，表示檢索成功，failturefailture failture failture failture表示檢索失敗表示檢索失敗 表示檢索失敗表示檢索失敗4.otherInfootherInfootherInfo otherInfo otherInfootherInfo可選element el

42、ement其他信息其他信息備用4.響 應(yīng) 報(bào) 文 體 模 板3720b175-7db7-408d-90cd-108e1f2ec8879 success 6.2.2資源目錄檢索結(jié)果提取目錄檢索結(jié)果由服務(wù)器端從結(jié)果集中提取并返回若干數(shù)據(jù)記錄給客戶端。1.請(qǐng)求報(bào)文體 序號(hào)元素名稱元素名稱約束類型長(zhǎng)度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceId referenceId必選StringStringStringString String 50會(huì)話標(biāo)識(shí)會(huì)話標(biāo)識(shí)2.resultSetIDresultSetID resultSetID resu

43、ltSetIDresultSetID resultSetID必選StringStringStringString String要抽取的 要抽取的 要抽取的 要抽取的 結(jié)果集的 結(jié)果集的 結(jié)果集的 結(jié)果集的標(biāo)識(shí) 因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù) 因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù)因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù)因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù)因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù) 因?yàn)橄到y(tǒng)允許在抽取數(shù)據(jù) 因?yàn)橄到y(tǒng)允許在抽 取數(shù)據(jù) 前進(jìn)行多次檢 索，每前進(jìn)行多次檢 索，每前進(jìn)行多次檢 索，每前進(jìn)行多次檢 索，每前進(jìn)行多次檢索，每前進(jìn)行多次檢索，每前進(jìn)行多次檢 索，每索都可以指定不同的結(jié)果 索都可以指定不同的結(jié)果索都可以指定不同的結(jié)果索都可以指定不同的結(jié)果

44、索都可以指定不同的結(jié)果索都可以指定不同的結(jié)果 索都可以指定不同的結(jié)果集名稱，所以客戶端必須 集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須指定要抽取 的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集指定要抽取的數(shù)據(jù)結(jié)果集標(biāo)識(shí)3.resultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPr

45、esultSetStartP resultSetStartPointoint oint必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString 20開始抽取開始抽取開始抽取開始抽取的位置 客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記 錄開始抽取，序號(hào)從錄開始抽取，序號(hào)從錄開始抽取，序號(hào)從 錄開始抽取，序號(hào)從1開始4.numberOfReco num

46、berOfReconumberOfReco numberOfReconumberOfReconumberOfReco numberOfRecordsResquestedrdsResquestedrdsResquestedrdsResquested rdsResquested rdsResquestedrdsResquested必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString 20記錄數(shù)客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶

47、端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記錄數(shù)5.elementSetNa elementSetNaelementSetNaelementSetNa elementSetNa me必選element element結(jié)果集屬結(jié)果集屬結(jié)果集屬結(jié)果集屬性參見表參見表A.3A.3 elementSetName elementSetNameelementSetNameelementSetNameelementSetName elementSetNameelementSetName結(jié)果 集 屬性集屬性智慧城市公共信息平臺(tái)-平臺(tái)接口與服務(wù)要求166.preferredRecor preferredRecorpreferredRecorpreferredRecorpreferredRecorpre