DB3502T 056.3-2020 政務信息共享協(xié)同平臺 第3部分：接入要求

3502/TThesharingandcollaborativeplatformofgovernmentinformation—Part3：InterfacerequireI 2 2 3 3 4 4 5 6 6 7 7 8 8 8 8 9 參考文獻..............................................................................39本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本文件為DB3502/T056《政務信息共享協(xié)同平臺技術(shù)規(guī)范》的第3部分。DB3502/T056已發(fā)布了以d)增加接入日志記錄要求，建立調(diào)用方與平臺的對）；）；本文件起草單位：廈門暢享信息技術(shù)有限公司、廈門市標準化研究院、廈門市信息中入要求、二次開發(fā)的技術(shù)標準，擬由四個部分——第1部分：總體設計。目的在于確立平臺關(guān)鍵技體架構(gòu)滿足國家對政務信息交換與共享的要求，明確平臺內(nèi)主要功能模塊和模塊間的邏輯關(guān)——第2部分：資源管理。目的在于規(guī)范平臺所支持的多平臺對外服務的兼容性提供保障；明確平臺不同類型資源的屬性，統(tǒng)一屬性分類，為平臺對外服務的通用性提供保障；針對資源生產(chǎn)、資源注冊、源目錄、資源檢索、資源版本、資源安全等操作提出全生命周期管理要求，為平臺對外服務——第3部分：接入要求。目的在于將平臺對外接口標準化，明確接口在安全性、易用性、穩(wěn)定性方面要求，進一步提升平臺對外提供服務的能力和質(zhì)量，并入、平臺資源生產(chǎn)方、平臺資源消費方、區(qū)級平臺接入等方面，明確接入的實現(xiàn)方式，為保——第4部分：二次開發(fā)。目的在于規(guī)范平臺提供二次開發(fā)的工作方為后續(xù)平臺業(yè)務流程及插件的完善提供統(tǒng)一標準，既避免了平允許不同部門結(jié)合特定業(yè)務需要，在授權(quán)范圍內(nèi)擴展1政務信息共享協(xié)同平臺第3部分：接入要求本文件規(guī)定了生產(chǎn)方、消費方、區(qū)級平臺接入政務信息共享協(xié)同平臺的技術(shù)DB3502/T056.1—2020政務信息共享協(xié)同平臺第1部分：總體DB3502/T056.2—2020政務信息共享協(xié)同平臺第2部分：資源管理DB3502/T056.1—2020、DB3502/T056.2—2020界定的以及下列術(shù)語和定義適用于本文件?；诜樟鞒桃?，融合多個原子服務，實現(xiàn)將多個細顆23網(wǎng)絡鏈路架構(gòu)見圖1。分控中心應采用獨立的服務器作為接入前置c)部署接入前置機應由部門端和總控中心雙方共同管理。前置機上主要部署分控中心所需的軟含義參照DB3502/T056.2—2020中5.MessageFormatandProtoc.2接入本平臺的服務方默認只支持基本數(shù)據(jù)類型，以消除由于使用不同語言、不同框架實現(xiàn)式接入。服務的報文格式及交換形式滿足HTTP1.0或HTTP1.1傳輸協(xié)議，采用GET或POST方法提起請求，采用JSON格式、XML或自定義純文本作為請求或回應報文的載4a)不做身份認證僅加密報文。b)加密報文且實現(xiàn)請求方通過證書驗證服務方，服務方不驗證請求方。c)加密報文且請求與服務方相互驗證對方身份三種安全交換方式。數(shù)據(jù)文件資源接入涉及到兩類用戶，分控管理員和總數(shù)據(jù)文件資源應符合以下要求，以提供穩(wěn)定的數(shù)據(jù)資數(shù)據(jù)庫表資源接入涉及到兩類用戶，分控管理員和總資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5d)數(shù)據(jù)庫表的字段類型應在可共享字段類型范圍內(nèi)，暫不支MySQL字段NUMBERMEDIUMINTMEDIUMTEXTMEDIUMBLOB期、共享類型、共享范圍、協(xié)議類型、服務IP地址、服務端口、資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5.1的6編碼(選填)7憑證令牌獲取URL地址說明a)第一步：分控管理員填寫信息并申請使用數(shù)據(jù)文件b)第二步：消費方或消費方的應用系統(tǒng)通過SFTP協(xié)議或指定的文件接收目錄，獲取相應的數(shù)據(jù)b)申請ID:用于在協(xié)同平臺表征本次申請行為的唯一英文標記；c)聯(lián)系人：指定請求申請目標數(shù)據(jù)文件資源的聯(lián)系人信息；d)聯(lián)系人電話：指定請求申請目標數(shù)據(jù)文件資源的聯(lián)系人電話；f)授權(quán)應用系統(tǒng)：指定請求申請目標數(shù)據(jù)文件資源所用的授權(quán)應用系統(tǒng)；g)接收方式：指定數(shù)據(jù)文件資源的接收方式，包含SFTP和本地目錄兩種方式。SFTP模式需提交消費方使用數(shù)據(jù)庫b)第二步：總控管理員配置數(shù)據(jù)庫交換方案，將數(shù)據(jù)同步到前置庫或推送到業(yè)務庫；c)第三步：消費方按要求從前置庫或本地業(yè)務庫獲取結(jié)果數(shù)據(jù)。89b)獲取可申請服務接口：獲得查看市級平臺所有可向區(qū)級平臺開放的服務目錄列表；d)申請服務接口：調(diào)用該接口，可向市級平臺申請區(qū)級f)調(diào)用服務接口：調(diào)用已通過“申請服務接口”,并完成并通過申請的市級平臺服務。8.2.2審核通過后，指定應用即可上線調(diào)用指定的市8.2.3應用審核通過后，應獲得由市級平臺自動分配給本應用的且不可更改的AppID和SecretKey8.2.4具體操作流程如下：b)信息填寫完成并提交審核后，進入審核階段；8.3.1擁有平臺用戶帳號和應用AppID和SecretKey后，應用應憑借二者調(diào)用資源，調(diào)用時序見圖8.3.2調(diào)用平臺中不需要權(quán)限的API時，宜直接調(diào)用，無須攜帶AccessToken,但仍應對參數(shù)進行簽名。對于平臺中需要權(quán)限的API,第三方應用應先進行一個登陸驗證，獲取調(diào)用時將AccessToken作為參數(shù)。(平臺對接接口應符合8.5的要求)。傳入及返回字符集均采用UTF-8格式。圖4平臺服務接口調(diào)用時序是應用的唯一ID。通過appid查找APP基本信息。是否返回值的格式。請指定為JSON或者XML,缺省值小寫是特別說明不需要的均需攜帶此參數(shù))返回碼。如果錯誤，返回錯誤信息。urlencode(a=x&b=y&..2)請求的URI路徑(不含HOST):/user/get_info;1)將請求的URI路徑進行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請求方式、1）以及3）中的到的字符串用&拼接起來，得到源串：GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaGET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaon%26name%3Djack&12注：除非接口文檔中特別標注了某參數(shù)不參與簽名，功能說明：獲取需要授權(quán)的Res請求地址：/auth/tok公共參數(shù)：發(fā)送請求時應傳入公共參是是返回參數(shù)說明：包含公共返回參數(shù)和業(yè)務返回參數(shù)。登錄驗功能說明：退出登錄的操作，注銷a請求地址：/auth/e公共參數(shù)：發(fā)送請求時應傳入公共參功能說明：獲取指定表碼表的請求地址：/system/get_table_c公共參數(shù)：發(fā)送請求時應傳入公共參是返回參數(shù)說明：包含公共返回參數(shù)和業(yè)務返回參數(shù)。表碼功能說明：獲取本單位發(fā)布的服務列表。第三方應用應根據(jù)服務狀態(tài)和審核狀態(tài)請求地址：/service/get_my_serv公共參數(shù)：發(fā)送請求時應傳入公共參否否否否返回參數(shù)說明：包含公共返回參數(shù)和wsdl請求地址：/service/save_serv否作是最終存儲在平臺為：XM.GOV.YZ.D是否是是是是是是否否是否wsdl是是是是是是是是否是否否是是是是是參數(shù)輸入順序的排序值，用兩位的數(shù)字字符串表示，如：功能說明：獲取服務的詳細信請求地址：/service/get_service_i是否否是是返回參數(shù)說明：包含公共返回參數(shù)和wsdl是是是是參數(shù)輸入順序的排序值，請用兩位的數(shù)字字符串表示，如：是是是是是是是是是是請求地址：/service/submit_servi公共參數(shù)：發(fā)送請求時必須傳入公共參數(shù)。是是參數(shù)值組成的json串，組成規(guī)則為參數(shù)名為key，參數(shù)值為是返回參數(shù)說明：包含公共返回參數(shù)和8.5.10獲取可申請的外部服務列表功能說明：獲取其他部門單位的服務列表。請求地址：/service/get_external_servic公共參數(shù)：發(fā)送請求時必須傳入公共參數(shù)。否否否否否默認2種類型均顯示1：已申請；2：尚未申請）wsdlWSDL地址8.5.11獲取申請過的外部服務列表功能說明：獲取其他部門單位的服務列表。請求地址：/service/get_apply_service業(yè)務參數(shù)：獲取申請過的外部服務否否否否否）；wsdl請求地址：/service/apply_servi業(yè)務參數(shù)：申請外部是是是是是是否返回參數(shù)：包含公共返回參數(shù)和業(yè)務返回參數(shù)，申請外部服務接a)通過協(xié)同平臺的授權(quán)地址獲取資源動態(tài)憑證令牌；b)通過協(xié)同平臺的服務調(diào)用地址訪問相應的服務，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}*平臺異常信息，如果項目有全局處理異常宜將該內(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