3502/TThesharingandcollaborativeplatformofgovernmentinformation—Part3：InterfacerequireI 2 2 3 3 4 4 5 6 6 7 7 8 8 8 8 9 參考文獻(xiàn)..............................................................................39本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本文件為DB3502/T056《政務(wù)信息共享協(xié)同平臺(tái)技術(shù)規(guī)范》的第3部分。DB3502/T056已發(fā)布了以d)增加接入日志記錄要求，建立調(diào)用方與平臺(tái)的對(duì)）；）；本文件起草單位：廈門暢享信息技術(shù)有限公司、廈門市標(biāo)準(zhǔn)化研究院、廈門市信息中入要求、二次開(kāi)發(fā)的技術(shù)標(biāo)準(zhǔn)，擬由四個(gè)部分——第1部分：總體設(shè)計(jì)。目的在于確立平臺(tái)關(guān)鍵技體架構(gòu)滿足國(guó)家對(duì)政務(wù)信息交換與共享的要求，明確平臺(tái)內(nèi)主要功能模塊和模塊間的邏輯關(guān)——第2部分：資源管理。目的在于規(guī)范平臺(tái)所支持的多平臺(tái)對(duì)外服務(wù)的兼容性提供保障；明確平臺(tái)不同類型資源的屬性，統(tǒng)一屬性分類，為平臺(tái)對(duì)外服務(wù)的通用性提供保障；針對(duì)資源生產(chǎn)、資源注冊(cè)、源目錄、資源檢索、資源版本、資源安全等操作提出全生命周期管理要求，為平臺(tái)對(duì)外服務(wù)——第3部分：接入要求。目的在于將平臺(tái)對(duì)外接口標(biāo)準(zhǔn)化，明確接口在安全性、易用性、穩(wěn)定性方面要求，進(jìn)一步提升平臺(tái)對(duì)外提供服務(wù)的能力和質(zhì)量，并入、平臺(tái)資源生產(chǎn)方、平臺(tái)資源消費(fèi)方、區(qū)級(jí)平臺(tái)接入等方面，明確接入的實(shí)現(xiàn)方式，為?！?部分：二次開(kāi)發(fā)。目的在于規(guī)范平臺(tái)提供二次開(kāi)發(fā)的工作方為后續(xù)平臺(tái)業(yè)務(wù)流程及插件的完善提供統(tǒng)一標(biāo)準(zhǔn)，既避免了平允許不同部門結(jié)合特定業(yè)務(wù)需要，在授權(quán)范圍內(nèi)擴(kuò)展1政務(wù)信息共享協(xié)同平臺(tái)第3部分：接入要求本文件規(guī)定了生產(chǎn)方、消費(fèi)方、區(qū)級(jí)平臺(tái)接入政務(wù)信息共享協(xié)同平臺(tái)的技術(shù)DB3502/T056.1—2020政務(wù)信息共享協(xié)同平臺(tái)第1部分：總體DB3502/T056.2—2020政務(wù)信息共享協(xié)同平臺(tái)第2部分：資源管理DB3502/T056.1—2020、DB3502/T056.2—2020界定的以及下列術(shù)語(yǔ)和定義適用于本文件。基于服務(wù)流程引擎，融合多個(gè)原子服務(wù)，實(shí)現(xiàn)將多個(gè)細(xì)顆23網(wǎng)絡(luò)鏈路架構(gòu)見(jiàn)圖1。分控中心應(yīng)采用獨(dú)立的服務(wù)器作為接入前置c)部署接入前置機(jī)應(yīng)由部門端和總控中心雙方共同管理。前置機(jī)上主要部署分控中心所需的軟含義參照DB3502/T056.2—2020中5.MessageFormatandProtoc.2接入本平臺(tái)的服務(wù)方默認(rèn)只支持基本數(shù)據(jù)類型，以消除由于使用不同語(yǔ)言、不同框架實(shí)現(xiàn)式接入。服務(wù)的報(bào)文格式及交換形式滿足HTTP1.0或HTTP1.1傳輸協(xié)議，采用GET或POST方法提起請(qǐng)求，采用JSON格式、XML或自定義純文本作為請(qǐng)求或回應(yīng)報(bào)文的載4a)不做身份認(rèn)證僅加密報(bào)文。b)加密報(bào)文且實(shí)現(xiàn)請(qǐng)求方通過(guò)證書驗(yàn)證服務(wù)方，服務(wù)方不驗(yàn)證請(qǐng)求方。c)加密報(bào)文且請(qǐng)求與服務(wù)方相互驗(yàn)證對(duì)方身份三種安全交換方式。數(shù)據(jù)文件資源接入涉及到兩類用戶，分控管理員和總數(shù)據(jù)文件資源應(yīng)符合以下要求，以提供穩(wěn)定的數(shù)據(jù)資數(shù)據(jù)庫(kù)表資源接入涉及到兩類用戶，分控管理員和總資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5d)數(shù)據(jù)庫(kù)表的字段類型應(yīng)在可共享字段類型范圍內(nèi)，暫不支MySQL字段NUMBERMEDIUMINTMEDIUMTEXTMEDIUMBLOB期、共享類型、共享范圍、協(xié)議類型、服務(wù)IP地址、服務(wù)端口、資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5.1的6編碼(選填)7憑證令牌獲取URL地址說(shuō)明a)第一步：分控管理員填寫信息并申請(qǐng)使用數(shù)據(jù)文件b)第二步：消費(fèi)方或消費(fèi)方的應(yīng)用系統(tǒng)通過(guò)SFTP協(xié)議或指定的文件接收目錄，獲取相應(yīng)的數(shù)據(jù)b)申請(qǐng)ID:用于在協(xié)同平臺(tái)表征本次申請(qǐng)行為的唯一英文標(biāo)記；c)聯(lián)系人：指定請(qǐng)求申請(qǐng)目標(biāo)數(shù)據(jù)文件資源的聯(lián)系人信息；d)聯(lián)系人電話：指定請(qǐng)求申請(qǐng)目標(biāo)數(shù)據(jù)文件資源的聯(lián)系人電話；f)授權(quán)應(yīng)用系統(tǒng)：指定請(qǐng)求申請(qǐng)目標(biāo)數(shù)據(jù)文件資源所用的授權(quán)應(yīng)用系統(tǒng)；g)接收方式：指定數(shù)據(jù)文件資源的接收方式，包含SFTP和本地目錄兩種方式。SFTP模式需提交消費(fèi)方使用數(shù)據(jù)庫(kù)b)第二步：總控管理員配置數(shù)據(jù)庫(kù)交換方案，將數(shù)據(jù)同步到前置庫(kù)或推送到業(yè)務(wù)庫(kù)；c)第三步：消費(fèi)方按要求從前置庫(kù)或本地業(yè)務(wù)庫(kù)獲取結(jié)果數(shù)據(jù)。89b)獲取可申請(qǐng)服務(wù)接口：獲得查看市級(jí)平臺(tái)所有可向區(qū)級(jí)平臺(tái)開(kāi)放的服務(wù)目錄列表；d)申請(qǐng)服務(wù)接口：調(diào)用該接口，可向市級(jí)平臺(tái)申請(qǐng)區(qū)級(jí)f)調(diào)用服務(wù)接口：調(diào)用已通過(guò)“申請(qǐng)服務(wù)接口”,并完成并通過(guò)申請(qǐng)的市級(jí)平臺(tái)服務(wù)。8.2.2審核通過(guò)后，指定應(yīng)用即可上線調(diào)用指定的市8.2.3應(yīng)用審核通過(guò)后，應(yīng)獲得由市級(jí)平臺(tái)自動(dòng)分配給本應(yīng)用的且不可更改的AppID和SecretKey8.2.4具體操作流程如下：b)信息填寫完成并提交審核后，進(jìn)入審核階段；8.3.1擁有平臺(tái)用戶帳號(hào)和應(yīng)用AppID和SecretKey后，應(yīng)用應(yīng)憑借二者調(diào)用資源，調(diào)用時(shí)序見(jiàn)圖8.3.2調(diào)用平臺(tái)中不需要權(quán)限的API時(shí)，宜直接調(diào)用，無(wú)須攜帶AccessToken,但仍應(yīng)對(duì)參數(shù)進(jìn)行簽名。對(duì)于平臺(tái)中需要權(quán)限的API,第三方應(yīng)用應(yīng)先進(jìn)行一個(gè)登陸驗(yàn)證，獲取調(diào)用時(shí)將AccessToken作為參數(shù)。(平臺(tái)對(duì)接接口應(yīng)符合8.5的要求)。傳入及返回字符集均采用UTF-8格式。圖4平臺(tái)服務(wù)接口調(diào)用時(shí)序是應(yīng)用的唯一ID。通過(guò)appid查找APP基本信息。是否返回值的格式。請(qǐng)指定為JSON或者XML,缺省值小寫是特別說(shuō)明不需要的均需攜帶此參數(shù))返回碼。如果錯(cuò)誤，返回錯(cuò)誤信息。urlencode(a=x&b=y&..2)請(qǐng)求的URI路徑(不含HOST):/user/get_info;1)將請(qǐng)求的URI路徑進(jìn)行URL編碼(URI不含host),得到：%2Fuser%2Fget_info;3)將2）中排序后的參數(shù)(key=value)用&拼接：access_token=e1&format=json&name=jack；編碼結(jié)果為：access_token%3De123456%26appid%3D123456%26format%5)將HTTP請(qǐng)求方式、1）以及3）中的到的字符串用&拼接起來(lái)，得到源串：GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaGET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaon%26name%3Djack&12注：除非接口文檔中特別標(biāo)注了某參數(shù)不參與簽名，功能說(shuō)明：獲取需要授權(quán)的Res請(qǐng)求地址：/auth/tok公共參數(shù)：發(fā)送請(qǐng)求時(shí)應(yīng)傳入公共參是是返回參數(shù)說(shuō)明：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)。登錄驗(yàn)功能說(shuō)明：退出登錄的操作，注銷a請(qǐng)求地址：/auth/e公共參數(shù)：發(fā)送請(qǐng)求時(shí)應(yīng)傳入公共參功能說(shuō)明：獲取指定表碼表的請(qǐng)求地址：/system/get_table_c公共參數(shù)：發(fā)送請(qǐng)求時(shí)應(yīng)傳入公共參是返回參數(shù)說(shuō)明：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)。表碼功能說(shuō)明：獲取本單位發(fā)布的服務(wù)列表。第三方應(yīng)用應(yīng)根據(jù)服務(wù)狀態(tài)和審核狀態(tài)請(qǐng)求地址：/service/get_my_serv公共參數(shù)：發(fā)送請(qǐng)求時(shí)應(yīng)傳入公共參否否否否返回參數(shù)說(shuō)明：包含公共返回參數(shù)和wsdl請(qǐng)求地址：/service/save_serv否作是最終存儲(chǔ)在平臺(tái)為：XM.GOV.YZ.D是否是是是是是是否否是否wsdl是是是是是是是是否是否否是是是是是參數(shù)輸入順序的排序值，用兩位的數(shù)字字符串表示，如：功能說(shuō)明：獲取服務(wù)的詳細(xì)信請(qǐng)求地址：/service/get_service_i是否否是是返回參數(shù)說(shuō)明：包含公共返回參數(shù)和wsdl是是是是參數(shù)輸入順序的排序值，請(qǐng)用兩位的數(shù)字字符串表示，如：是是是是是是是是是是請(qǐng)求地址：/service/submit_servi公共參數(shù)：發(fā)送請(qǐng)求時(shí)必須傳入公共參數(shù)。是是參數(shù)值組成的json串，組成規(guī)則為參數(shù)名為key，參數(shù)值為是返回參數(shù)說(shuō)明：包含公共返回參數(shù)和8.5.10獲取可申請(qǐng)的外部服務(wù)列表功能說(shuō)明：獲取其他部門單位的服務(wù)列表。請(qǐng)求地址：/service/get_external_servic公共參數(shù)：發(fā)送請(qǐng)求時(shí)必須傳入公共參數(shù)。否否否否否默認(rèn)2種類型均顯示1：已申請(qǐng)；2：尚未申請(qǐng)）wsdlWSDL地址8.5.11獲取申請(qǐng)過(guò)的外部服務(wù)列表功能說(shuō)明：獲取其他部門單位的服務(wù)列表。請(qǐng)求地址：/service/get_apply_service業(yè)務(wù)參數(shù)：獲取申請(qǐng)過(guò)的外部服務(wù)否否否否否）；wsdl請(qǐng)求地址：/service/apply_servi業(yè)務(wù)參數(shù)：申請(qǐng)外部是是是是是是否返回參數(shù)：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)，申請(qǐng)外部服務(wù)接a)通過(guò)協(xié)同平臺(tái)的授權(quán)地址獲取資源動(dòng)態(tài)憑證令牌；b)通過(guò)協(xié)同平臺(tái)的服務(wù)調(diào)用地址訪問(wèn)相應(yīng)的服務(wù)，importcom.alibaba.importjava.security.Keimportjava.security.NoSucimportjava.security.certimportjava.security.import.ssl**privatestaticfinalStringXSH"https://6:20184/core/request/token?appIprivatestaticfinalStr"ff8080816e399e4e01privatestaticfinalStringXSHAR"https://6/core/Ynqqqq?acStringqueryTokenUrl=MessageFormat.format(XSHARXSHARE_APP_ID,XSHARE_JSONObjectaccessTokenInfo=queryAccessToken(quStringcallServiceUrl=MessageFormat.format(XSHARE_accessTokenInfo.getString("accesByteArrayOutputStreamresult=post(callServiceUrl,jSystem.out.println(result.toString("UTFSystem.out.println(e.getSystem.out.println(e.getSystem.out.println(e.getMSystem.out.println(e.geSystem.out.println(e.getSystem.out.println(e.ge}}**@throwsPoseidonEprivatestaticJSONObjectqueryAccessthrowsIOException,PoByteArrayOutputStreamresult=get(url,timJSONObjectaccessToken}*@throwsPoseidonEpublicstaticByteAthrowsIOException,PoByteArrayOutputStreamresult=request(url,"GET",null,t}*@throwsNoSuchAlgorithmE*@throwsKeyManagementEpublicstaticByteArrayOutputStreampost(StringtimeOut)throwsIOException,PoByteArrayOutputStreamresult=request(url,"POST",param,}privatestaticByteArrayOutputStreamrequest(Stringurl,Striconnection.setConnectTimeout(connection.setReadTimeout(tconnection.setRequestMconnection.setRequestProperty("POSEOutputStreamoutputStream=connection.getOutpoutputStream.write(requestParam.getBytes("UT}ByteArrayOutputStreamresult=copyStreamToByteArrayOutputStream(connection.getthrownewPoseidonException(connection.geresult.toString("UTF}ByteArrayOutputStreamresult=copyStreamToByteArrayOutputStream(connection.getIn}privatestaticByteArrayOutpreturnnewByteArrayOutputSByteArrayOutputStreamout=newByteArrayOutputStrebyte[]buffer=newbyteout.write(buffer,0,}}**@throwsKeyManagementE*@throwsNoSuchAlgorithprivatestaticvoidallowAllHostKeyManagementException,NoSuchAlgorithmETrustManager[]trustAllCerts=newTrustManagepublicvoidcheckClientTrusted(X509Certificate[]x509CerStrings)throwsCerti}publicvoidcheckServerTrusted(X509Certificate[]x509CerStrings)throwsCertific}returnnewX509Certif}SSLContextsslContext=SSLContext.getInstance(sslContext.init(null,trHttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFaHostnameVerifierhostnameVerifier=newHostnameVerHttpsURLConnection.setDefaultHostnameVerifier(hostnameV}*平臺(tái)異常信息，如果項(xiàng)目有全局處理異常宜將該內(nèi)部類移到}}}POST/auth/tokenHTTContent-Type:application/x-www-form-urlen&login_name=admin&pwd=9iaaaabbdsss&sig=75897972f153d6509988227fa8bba9ab{"data":{"access_token":"10000f771b200}<?xmlversion="1.0"encoding=POST/auth/exitHTTContent-Type:application/x-www-form-urlenappid=123456&format=json&access_token=e123456&sig=bc529866f252b086db2b40f22f{}<?xmlversion="1.0"encoding=POST/service/get_table_codeHTTContent-Type:application/x-www-form-urlenappid=123456&format=json&access_token=e123456&table_id=1&sig=e473e175162b14bf52e321c{{{}<?xmlversion="1.0"encoding=POST/service/get_my_service_listHTContent-Type:application/x-www-form-urlen&access_token=e123456&review_status=0&service_status=0&sig=e473e175162b14bf52e321cff4c5e52d{{"id":"ff8080813c195804013"service_id":"XM.GOV."expiration_date":"2"wsdl":"HTTP://42:8082/ws/services/hel}<?xmlversion="1.0"encoding={{}<?xmlversion="1.0"encoding=POST/service/get_my_service_listHTContent-Type:application/x-www-form-urlen&access_token=e123456&id=1234567890&sig=e473e175162b14bf52e321cff4c5e52d{"wsdl":"HTTP://42:8082/ws001/services/"service_type":"1","service_na"id":"ff8080813d47949101"authorize_dept_cn":""instruction":"","review_status":"1","se"keyword":"","doc_type":"","output"xsd_name":"","is_enabled":"0","review_date":{"input_type":"int","input_name":"a","input_directions":"a","in{"input_type":"int","input_name":"b","input_directions":"b","develop_language":"Java","expiration_date":"20230308235959","is_private":"0"rk":"Spring","method":"Addservices","output_type":"","call_directions":"","service_}<?xmlversion="1.0"encoding=<itemname="service_id">XM.GOV.YZ.D<itemname="departm<itemname="wsdl">HTTP://42:8082/ws001/services/Addservi<itemname="departm<itemname="review_op<itemname="service<itemname="service_name">人口家<itemname="concurrent_l<itemname="id">ff8080813d479491013d4947<itemname="develop_framework_<itemname="authorize_dept">RS,G<itemname="output_err<itemname="create_date">2013030<itemname="authorize_dept_cn">人社,公安,<itemname="review_<itemname="service_s<itemname="output_dire<itemname="review_date">20130na