版權(quán)說(shuō)明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡(jiǎn)介
DB52DB52/T1261—2018政務(wù)云貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)接入規(guī)范貴州省質(zhì)量技術(shù)監(jiān)督局發(fā)布I 1 1 2 2 4 6 8 1政務(wù)云貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)接入規(guī)范本標(biāo)準(zhǔn)規(guī)定了貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)接入的基本要求、接入要求、運(yùn)維管理要求。本標(biāo)準(zhǔn)適用于需要接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)的業(yè)務(wù)應(yīng)用系統(tǒng)。2術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。貴州省電子政務(wù)網(wǎng)貴州省電子政務(wù)網(wǎng)是由貴州省人民政府辦公廳牽頭統(tǒng)一建設(shè)的,面向全省各級(jí)政府及其部門,集協(xié)同工作、學(xué)習(xí),加強(qiáng)內(nèi)部管理、交流等功能為一體的全省政府系統(tǒng)行政辦公總平臺(tái)及總?cè)肟?,是貴州省電子政務(wù)云的一個(gè)重要應(yīng)用平臺(tái),其基于國(guó)家電子政務(wù)外網(wǎng)環(huán)境建設(shè),功能定位主要是為全省政府系統(tǒng)公務(wù)人員提供信息資源共享、數(shù)據(jù)互聯(lián)互通和聯(lián)動(dòng)辦公服務(wù)。政務(wù)服務(wù)開放平臺(tái)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)中專用于為本標(biāo)準(zhǔn)規(guī)范所定義的業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)進(jìn)行管理的一個(gè)子系統(tǒng)。主要用于對(duì)需要接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)的業(yè)務(wù)應(yīng)用系統(tǒng)、服務(wù)、服務(wù)提供方、服務(wù)使用方等各種要素信息進(jìn)行流程化的管理維護(hù)。業(yè)務(wù)應(yīng)用系統(tǒng)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)中接入的各種解決政務(wù)業(yè)務(wù)需求的軟件系統(tǒng)。包括貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)中已有的基礎(chǔ)辦公系統(tǒng)、接入的其它第三方廠商軟件系統(tǒng)等,但不包括平臺(tái)底層支撐組件。服務(wù)接入的業(yè)務(wù)應(yīng)用系統(tǒng)中的某些功能利用技術(shù)接口的方式單獨(dú)提供出來(lái)供其它業(yè)務(wù)應(yīng)用系統(tǒng)調(diào)用的形式稱為服務(wù),例如發(fā)送工作文件服務(wù)、查詢機(jī)構(gòu)信息服務(wù)、監(jiān)聽接收和發(fā)送公文服務(wù)等等。2DB52/T1261—20182.5服務(wù)提供方提供完整業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù),并將業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)在政務(wù)服務(wù)開放平臺(tái)中注冊(cè)并發(fā)布的組織或機(jī)構(gòu)。2.6服務(wù)使用方需要調(diào)用政務(wù)服務(wù)開放平臺(tái)上發(fā)布的服務(wù)或業(yè)務(wù)應(yīng)用系統(tǒng)的組織或機(jī)構(gòu)。2.7平臺(tái)運(yùn)營(yíng)方對(duì)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)進(jìn)行運(yùn)維和管理服務(wù)的組織或機(jī)構(gòu)。2.8業(yè)主單位在政務(wù)服務(wù)開放平臺(tái)中注冊(cè)的業(yè)務(wù)應(yīng)用系統(tǒng)的直接責(zé)任單位。3基本要求3.1業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)應(yīng)按4.4條進(jìn)行注冊(cè)。3.2業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)以貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)中的統(tǒng)一組織機(jī)構(gòu)人員數(shù)據(jù)庫(kù)作為基礎(chǔ)數(shù)據(jù)實(shí)現(xiàn)機(jī)構(gòu)人員數(shù)據(jù)共享。3.3業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)以貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)中的統(tǒng)一認(rèn)證系統(tǒng)作為身份認(rèn)證單點(diǎn)登錄的入口。3.4業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)按本標(biāo)準(zhǔn)中相應(yīng)技術(shù)接口服務(wù)規(guī)范向貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)推送操作日志、提醒消息、待辦事項(xiàng)等與工作相關(guān)的人員行為數(shù)據(jù)信息。3.5服務(wù)提供方及業(yè)主單位應(yīng)規(guī)范運(yùn)維和管理接入的業(yè)務(wù)應(yīng)用系統(tǒng)和服務(wù),確保正常運(yùn)行,不得影響到貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)的正常運(yùn)轉(zhuǎn)。4接入要求4.1接入網(wǎng)絡(luò)要求貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)運(yùn)行于國(guó)家電子政務(wù)外網(wǎng),業(yè)務(wù)應(yīng)用系統(tǒng)接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)應(yīng)通過(guò)國(guó)家電子政務(wù)外網(wǎng)環(huán)境進(jìn)行接入。4.2接入技術(shù)要求4.2.1服務(wù)提供方在提供服務(wù)技術(shù)接口時(shí),應(yīng)遵行以下接口要求:a)服務(wù)接口要求支持XML和JSON數(shù)據(jù)格式。XML遵行XML1.0第5版規(guī)范,JSON遵行RFC4627規(guī)范;并要求支持JAVA、PHP、Javascript、.NET等主流開發(fā)語(yǔ)言;b)服務(wù)接口要求支持SDK或API模式,并支持WebService或Restful兩種接口方式,同時(shí)提供詳細(xì)接口技術(shù)文檔。34.2.2業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)兼容支持HTML5標(biāo)準(zhǔn)規(guī)范的現(xiàn)代瀏覽器,移動(dòng)端應(yīng)支持Android4.流程4DB52/T1261—20184.4.2服務(wù)提供方注冊(cè)流程服務(wù)提供方完整填寫《業(yè)務(wù)系統(tǒng)注冊(cè)基本信息表》(見附錄A.1相關(guān)人員單位簽字用章后,提交給政務(wù)服務(wù)開放平臺(tái)管理人員。政務(wù)服務(wù)開放平臺(tái)管理人員負(fù)責(zé)審批服務(wù)提供方提交業(yè)務(wù)系統(tǒng)注冊(cè)基本信息,審批通過(guò)后配發(fā)業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人的登錄賬號(hào)密碼給服務(wù)提供方的業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人。業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人通過(guò)賬號(hào)密碼登錄到政務(wù)服務(wù)開放平臺(tái)進(jìn)行后續(xù)操作。4.4.3服務(wù)提供方申請(qǐng)發(fā)布服務(wù)流程業(yè)務(wù)應(yīng)用系統(tǒng)注冊(cè)基本信息審批通過(guò)后,服務(wù)提供方才可以進(jìn)行申請(qǐng)發(fā)布服務(wù)的流程。服務(wù)提供方完整填寫《服務(wù)發(fā)布申請(qǐng)基本信息表》(見附錄A.2相關(guān)人員單位簽字用章后,提交給政務(wù)服務(wù)開放平臺(tái)管理人員,審批通過(guò)后可在政務(wù)服務(wù)開放平臺(tái)中發(fā)布該服務(wù)。要發(fā)布的服務(wù)的每一個(gè)服務(wù)接口都需要單獨(dú)填寫一份《服務(wù)接口內(nèi)容信息表》(見附錄A.3提交給政務(wù)服務(wù)開放平臺(tái)管理人員。4.4.4服務(wù)使用方申請(qǐng)使用業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)流程申請(qǐng)業(yè)務(wù)應(yīng)用系統(tǒng)使用時(shí),完整填寫《業(yè)務(wù)應(yīng)用系統(tǒng)使用申請(qǐng)基本信息表》(見附錄A.5),提交給政務(wù)服務(wù)開放平臺(tái)管理人員,審批通過(guò)后將由業(yè)務(wù)應(yīng)用系統(tǒng)的服務(wù)提供方與申請(qǐng)單位聯(lián)系后續(xù)開通使用事宜。申請(qǐng)使用服務(wù)時(shí),完整填寫《服務(wù)使用申請(qǐng)基本信息表》(見附錄A.4提交給政務(wù)服務(wù)開放平臺(tái)管理人員,審批通過(guò)后申請(qǐng)方按相關(guān)技術(shù)規(guī)范使用,使用過(guò)程中的技術(shù)問(wèn)題由該服務(wù)的服務(wù)提供方提供支持。4.5接入技術(shù)規(guī)范4.5.1業(yè)務(wù)應(yīng)用系統(tǒng)在調(diào)用服務(wù)接口時(shí),應(yīng)先進(jìn)行身份鑒權(quán),接口鑒權(quán)規(guī)范見附錄B。4.5.2貴州省電子政務(wù)網(wǎng)平臺(tái)已提供的“基礎(chǔ)通用服務(wù)”類別的接口描述與技術(shù)規(guī)范見附錄C。4.5.3貴州省電子政務(wù)網(wǎng)平臺(tái)已提供的“政務(wù)業(yè)務(wù)事項(xiàng)服務(wù)”類別的接口描述與技術(shù)規(guī)范見附錄D。4.5.4接口返回代碼規(guī)范與對(duì)照表見附錄E。4.5.5服務(wù)提供方在發(fā)布其它服務(wù)時(shí)的設(shè)計(jì)規(guī)范見附錄F。5運(yùn)維管理要求5.1業(yè)主單位管理要求5.1.1業(yè)主單位負(fù)責(zé)本單位所選取的業(yè)務(wù)應(yīng)用系統(tǒng)的服務(wù)提供方的資質(zhì)與能力審核,并為該業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)進(jìn)行審批并承擔(dān)相應(yīng)管理責(zé)任。5.1.2業(yè)主單位負(fù)責(zé)協(xié)調(diào)所選取的業(yè)務(wù)應(yīng)用系統(tǒng)的服務(wù)提供方與平臺(tái)運(yùn)營(yíng)方的對(duì)接工作。5.1.3業(yè)主單位應(yīng)為本單位接入的業(yè)務(wù)應(yīng)用系統(tǒng)制定相應(yīng)的運(yùn)維策略與安全策略,并確保正常執(zhí)行。5.2服務(wù)提供方管理要求5.2.1服務(wù)提供方應(yīng)為業(yè)務(wù)應(yīng)用系統(tǒng)指定負(fù)責(zé)人,負(fù)責(zé)與平臺(tái)運(yùn)營(yíng)方進(jìn)行對(duì)接,并承擔(dān)管理責(zé)任。5.2.2服務(wù)提供方應(yīng)按規(guī)范提供業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù),并保障其正常穩(wěn)定的運(yùn)行于貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)之上。5.2.3服務(wù)提供方負(fù)責(zé)提供接入的業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)的技術(shù)支持和運(yùn)維服務(wù)。55.2.4服務(wù)提供方應(yīng)為接入的每一個(gè)業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)均提供測(cè)試報(bào)告,配合平臺(tái)運(yùn)營(yíng)方的要求做聯(lián)合調(diào)試工作,并確保其穩(wěn)定性。5.2.5負(fù)責(zé)自己管理的業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)的缺陷修正及更新發(fā)布等工作。5.3服務(wù)使用方管理要求5.3.1按照貴州省電子政務(wù)網(wǎng)開放平臺(tái)相關(guān)要求規(guī)范使用業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)。5.3.2在使用服務(wù)過(guò)程中如發(fā)現(xiàn)缺陷或需要改進(jìn)的地方,應(yīng)主動(dòng)與平臺(tái)運(yùn)營(yíng)方進(jìn)行溝通。5.4平臺(tái)運(yùn)營(yíng)方管理要求5.4.1負(fù)責(zé)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)接入的日常管理與技術(shù)支持。5.4.2負(fù)責(zé)平臺(tái)基礎(chǔ)通用服務(wù)和政務(wù)業(yè)務(wù)事項(xiàng)服務(wù)技術(shù)接口的維護(hù)更新與缺陷修正。5.5應(yīng)急處置5.5.1業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)發(fā)生嚴(yán)重故障時(shí),如影響到貴州省電子政務(wù)網(wǎng)應(yīng)用平臺(tái)或其它業(yè)務(wù)應(yīng)用系統(tǒng)的正常運(yùn)行時(shí),平臺(tái)運(yùn)營(yíng)方有權(quán)要求暫停該系統(tǒng)和服務(wù),直到整改正常方可申請(qǐng)恢復(fù)。6DB52/T1261—2018(規(guī)范性附錄)接入管理流程相關(guān)信息表A.1業(yè)務(wù)系統(tǒng)注冊(cè)基本信息表表A.1業(yè)務(wù)系統(tǒng)注冊(cè)基本信息表A.2服務(wù)使用申請(qǐng)基本信息表表A.2服務(wù)使用申請(qǐng)基本信息表7廠商名稱:廠商系統(tǒng)標(biāo)識(shí):已接入業(yè)務(wù)系統(tǒng):業(yè)務(wù)系統(tǒng)負(fù)責(zé)人:聯(lián)系電話:聯(lián)系郵箱:申請(qǐng)發(fā)布的服務(wù)類別和名稱:申請(qǐng)?zhí)峁┰颍悍?wù)廠商負(fù)責(zé)人簽名:業(yè)主單位聯(lián)系人簽名:服務(wù)廠商用章:業(yè)主單位用章:服務(wù)接口名稱:服務(wù)接口URL:所屬業(yè)務(wù)系統(tǒng):數(shù)據(jù)標(biāo)準(zhǔn)說(shuō)明:在線測(cè)試結(jié)果:申請(qǐng)單位名稱:聯(lián)系人:8DB52/T1261—2018(規(guī)范性附錄)接口鑒權(quán)規(guī)范B.1接口簽名使用規(guī)范B.1.1待簽名的字符串在請(qǐng)求參數(shù)列表中,除去sign簽名和token令牌參數(shù)外,其他需要使用到的參數(shù)都是需要簽名的參數(shù),相關(guān)要求如下:a)對(duì)于參數(shù)排序要求是按a到z的順序排序;b)參數(shù)統(tǒng)一使用小寫字母方式;c)若參數(shù)存在多層結(jié)構(gòu),只取第一層進(jìn)行簽名;d)若參數(shù)沒(méi)有值,無(wú)需包含到簽名數(shù)據(jù)列表中;e)根據(jù)HTTP協(xié)議要求,傳遞參數(shù)的值中如果存在特殊字符(如:&、@等),那么該值需要做URLEncoding;f)待簽名數(shù)據(jù)應(yīng)該是原生值而不是encoding之后的值。注:調(diào)用某接口需要對(duì)請(qǐng)求參數(shù)email進(jìn)行數(shù)字簽名,那么待簽名數(shù)據(jù)應(yīng)該是email=test@,而不是B.1.2待簽名字符串案例待簽名字符串格式采用URI中QUERY參數(shù)串的方式進(jìn)行組合,示例如下?!皊ervice=create_direct_pay_by_user”,“partner=2088101568338364”,“return_url=/alipay/return_url.asp”,“subject=訂單業(yè)務(wù)”,“payment_type=1”,“seller_email=test@”}partner=2088101568338364&payment_type=1&return_url=/alipay/return_url.asp&_email=test@&service=create_direct_pay_B.1.3進(jìn)行簽名B.1.3.1在簽名時(shí),需要私鑰參與簽名。私鑰是以事先分配給不同接入賬號(hào)的英文字母和數(shù)字組成的32位字符串。B.1.3.2當(dāng)拿到請(qǐng)求時(shí)的待簽名字符串后,需要把私鑰直接拼接到待簽名字符串的后面,形成新的字符串,利用SM3加密函數(shù)對(duì)這個(gè)新的字符串進(jìn)行簽名運(yùn)算,從而得到簽名結(jié)果字符串(該字符串賦值于參數(shù)sign),并將簽名結(jié)果字符串全部字母轉(zhuǎn)換為小寫字母。9B.2令牌使用規(guī)范使用基于Token的身份驗(yàn)證方法,大概的流程是這樣的:a)客戶端使用用戶名跟密碼請(qǐng)求登錄;b)服務(wù)端收到請(qǐng)求,去驗(yàn)證用戶名與密碼;串)簽發(fā)一個(gè)Token,再把這個(gè)Token發(fā)送給客戶端;d)客戶端收到Token以后可以把它存儲(chǔ)起來(lái),比如放在Cookie里;e)客戶端每次向服務(wù)端請(qǐng)求資源的時(shí)候需要帶著服務(wù)端簽發(fā)的Token,服務(wù)端收到請(qǐng)求,然后去驗(yàn)證客戶端請(qǐng)求里面帶著的Token,如果驗(yàn)證成功,就向客戶端返回請(qǐng)求的數(shù)據(jù)。B.3IP鑒權(quán)機(jī)制廠商在政務(wù)開放平臺(tái)注冊(cè)成功后,在調(diào)用接口前,都需要提供來(lái)訪的應(yīng)用IP地址,用于在服務(wù)調(diào)用前進(jìn)行IP鑒權(quán),鑒權(quán)成功后,服務(wù)接口才會(huì)響應(yīng)請(qǐng)求,對(duì)于使用負(fù)載均衡或無(wú)法提供固定應(yīng)用IP的應(yīng)用,可以提交申請(qǐng),告知開放平臺(tái)對(duì)特定應(yīng)用取消IP鑒權(quán)。B.4登錄安全規(guī)范B.4.1登錄認(rèn)證時(shí)所需要的參數(shù)說(shuō)明見表B.1。說(shuō)明字符串字符串字符串返回登錄信息字符串,多個(gè)字段以“,”分割。所有字段名全部小寫字符串字符串排除過(guò)濾路徑的資源,主要用于不需要進(jìn)行認(rèn)證就可以資源的訪問(wèn),支持目錄和指定后綴的模糊配置字符串系統(tǒng)推出后的通知接收URL,后臺(tái)認(rèn)證的多個(gè)系統(tǒng)中的任一系統(tǒng)推出后,系統(tǒng)會(huì)往成功登陸的其它系統(tǒng)發(fā)送消息,以實(shí)現(xiàn)單點(diǎn)退出功能。字符串(16位)個(gè)系統(tǒng)分配唯一一個(gè)Key,為了安全不能外傳。字符串DB52/T1261—2018B.4.2參數(shù)加密說(shuō)明登錄會(huì)對(duì)關(guān)鍵參數(shù)采用SM4加密,先加密得到二進(jìn)制串,然后將二進(jìn)制傳轉(zhuǎn)換為16進(jìn)制字符串進(jìn)行傳遞,傳遞到服務(wù)端后系統(tǒng)根據(jù)系統(tǒng)ID獲取對(duì)應(yīng)秘鑰,然后進(jìn)行解密后再進(jìn)行認(rèn)證登錄,加密的字段包括:systemid,loginOutUrl,backUrl,returnFields,uid,pwd。B.4.3參數(shù)簽名參見本標(biāo)準(zhǔn)附錄B.1接口簽名使用規(guī)范,簽名字符串用的是加密后的字符串。以Java語(yǔ)言舉例如下。示例:remoteLogin(Stringsys參數(shù)說(shuō)明見表B.2。表B.2參數(shù)表表C.1參數(shù)表參數(shù)名參數(shù)類型必須說(shuō)明是請(qǐng)求參數(shù)簽名是是是否應(yīng)用系統(tǒng)ID,可為空,如果為空則取視圖表設(shè)置的業(yè)務(wù)系統(tǒng)數(shù)據(jù),如果視圖是主要是用取單位從這個(gè)時(shí)間起到當(dāng)前為止,有變動(dòng)的數(shù)據(jù)是主要是用取部門從這個(gè)時(shí)間起到當(dāng)前為止,有變動(dòng)的數(shù)據(jù)是主要是用取人員從這個(gè)時(shí)間起到當(dāng)前為止,有變動(dòng)的數(shù)據(jù)是主要是用取身份從這個(gè)時(shí)間起到當(dāng)前為止,有變動(dòng)的數(shù)據(jù)是獲取數(shù)據(jù)類型,0取所有更新數(shù)據(jù)1只取單位更新數(shù)據(jù)2只取部門更新數(shù)據(jù)3只取人員更新數(shù)據(jù)4只取人員身份更新數(shù)據(jù)否否是用戶ID,主要用記錄是哪個(gè)用戶發(fā)過(guò)來(lái)的請(qǐng)是DB52/T1261—2018C.1.1.4響應(yīng)數(shù)據(jù)解析說(shuō)明返回?cái)?shù)據(jù)為XML格式,需要自行解析使用。<?xmlversion="1.0"encodin<returncode="0">獲取數(shù)<lastdatetime>2017-11-2914:50:01</la<lastdatetime>2017-11-1016:09:28</la<lastdatetime>2017-11-2823:24:25</la<lastdatetime>2017-10-1614:39:14</las注1:changeAccount:是單位變動(dòng)信息,countrows為獲取單位數(shù)據(jù)總記錄數(shù),loopcou將要循環(huán)向平臺(tái)取單位實(shí)際數(shù)據(jù)的次數(shù),lastdatetime是指單位數(shù)據(jù)更新最后時(shí)間,返回給客戶端供下次調(diào)C.1.2服務(wù)動(dòng)作C.1.2.1人員批量同步C.服務(wù)描述提供給第三方開發(fā)商,用于批量獲取人員數(shù)據(jù),批量獲取的數(shù)據(jù)支持分頁(yè)獲取,每頁(yè)返回最大行數(shù)不能超過(guò)100條,系統(tǒng)會(huì)默認(rèn)返回頁(yè)碼數(shù),記錄總行數(shù)、以及相關(guān)頁(yè)的數(shù)據(jù)明細(xì)。C.服務(wù)地址請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/org/getUserData?sign=&token=。C.請(qǐng)求參數(shù)說(shuō)明參數(shù)名必須說(shuō)明是請(qǐng)求參數(shù)簽名是是的認(rèn)證用戶名。不能為空。是分配的用戶密碼,密碼傳遞SM3加密后的字符串否查詢數(shù)據(jù)頁(yè)碼,不傳默認(rèn)獲取第一頁(yè)的數(shù)據(jù)否DB52/T1261—2018C.返回?cái)?shù)據(jù)返回?cái)?shù)據(jù)是一個(gè)XML格式的字符串,需要自行解析,示例格式如下。<?xmlversion="1.0"encodin<recordcount>記錄總數(shù)</<pagecount>總頁(yè)數(shù)</pagecount><pagesize>每頁(yè)記錄數(shù)</pagesize><orgsystemtype=“1”orgid=””數(shù)據(jù)類型用戶KEYID人員姓名人員編號(hào)身份證號(hào)登錄賬號(hào)登錄別名手機(jī)1手機(jī)2國(guó)產(chǎn)密碼SM33性別出生日期民族ID3是否為單位管理員1應(yīng)用系統(tǒng)ID串人員類型學(xué)歷是否政協(xié)委員333是否本單位領(lǐng)導(dǎo)3啟用標(biāo)記創(chuàng)建時(shí)間最后修改時(shí)間DB52/T1261—2018C.1.3機(jī)構(gòu)批量同步C.1.3.1服務(wù)描述提供給第三方開發(fā)商,用于批量獲取機(jī)構(gòu)數(shù)據(jù),批量獲取的數(shù)據(jù)支持分頁(yè)獲取,每頁(yè)返回最大行數(shù)不能超過(guò)2000條,系統(tǒng)會(huì)默認(rèn)返回頁(yè)碼數(shù),記錄總行數(shù)、以及相關(guān)頁(yè)的數(shù)據(jù)明細(xì)。C.1.3.2服務(wù)地址請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/org/getOrgData?sign=&token=。C.1.3.3請(qǐng)求參數(shù)說(shuō)明表C.3參數(shù)表是是是認(rèn)證用戶名,每個(gè)業(yè)務(wù)系統(tǒng)接入都會(huì)分配一個(gè)獨(dú)是否否<?xmlversion="1.0"encoding="UTF-8"<recordcount>記錄總數(shù)</recordcount><pagecount>總頁(yè)數(shù)</pagecount><pagesize>每頁(yè)記錄數(shù)</pagesize><systemtype>所屬體系1,政府2,人大,3政協(xié),4黨委</systemtype>DB52/T1261—201836363C.1.4機(jī)構(gòu)人員選擇C.1.4.1服務(wù)描述提供給第三方開發(fā)商,選擇人員和機(jī)構(gòu)的界面,首先要通過(guò)系統(tǒng)驗(yàn)證,系統(tǒng)會(huì)先生成隨機(jī)碼,隨機(jī)碼只能使用一次,使用后自動(dòng)作廢。C.1.4.2服務(wù)地址請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/org/getSelectUser?sigC.1.4.3請(qǐng)求參數(shù)說(shuō)明表C.4參數(shù)表參數(shù)名參數(shù)類型必須說(shuō)明是請(qǐng)求參數(shù)簽名是是獨(dú)立的認(rèn)證用戶名。不能為空。是分配的用戶密碼,密碼傳遞SM3加密后的字符串否1、返回機(jī)構(gòu)人員選擇界面注:如果傳入?yún)?shù)為空默認(rèn)為1C.1.4.4返回?cái)?shù)據(jù)返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。C.2統(tǒng)一認(rèn)證服務(wù)設(shè)計(jì)C.2.1遠(yuǎn)程系統(tǒng)登錄驗(yàn)證C.2.1.1服務(wù)描述提供給第三方開發(fā)商,提供給第三方調(diào)用,進(jìn)行用戶密碼認(rèn)證,認(rèn)證需要調(diào)用客戶端的API方法進(jìn)行驗(yàn)證,系統(tǒng)會(huì)對(duì)驗(yàn)證過(guò)程中的用戶名密碼等相關(guān)參數(shù)進(jìn)行簽名和命名重寫,保證傳輸過(guò)程中的數(shù)據(jù)安全,安全規(guī)則遵行本標(biāo)準(zhǔn)附錄B.4登錄安全規(guī)范執(zhí)行。統(tǒng)一認(rèn)證支持自定義登錄頁(yè)面,指的是業(yè)務(wù)系統(tǒng)采用自己的登錄界面,與后端認(rèn)證服務(wù)器進(jìn)行通信進(jìn)行認(rèn)證和創(chuàng)建票據(jù)。自定義登錄頁(yè)面的認(rèn)證過(guò)程和統(tǒng)一認(rèn)證登錄界面的認(rèn)證過(guò)程一樣,業(yè)務(wù)系統(tǒng)需要調(diào)用SDK包中的客戶端認(rèn)證方法即可。DB52/T1261—2018C.2.1.2服務(wù)地址請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/org/remoteLogin?sign=&token=。C.2.1.3請(qǐng)求參數(shù)說(shuō)明表C.5參數(shù)表是是是是是C.2.1.4返回?cái)?shù)據(jù)返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。<?xmlversion="1.0"encodinC.3統(tǒng)一日志服務(wù)C.3.1日志信息推送C.3.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:POST,請(qǐng)求地址:/api/base/log/push?sign=&token=。C.3.1.2請(qǐng)求包結(jié)構(gòu)體請(qǐng)求包結(jié)構(gòu)體數(shù)據(jù)是XML格式的字符串,示例格式如下。<?xmlversion="1.0"encoding="UTF-8"<mainOId>5235436557655</ma<operationType>修改臺(tái)帳</oper<operationId></opera<beOperationOLd>2231</beOperat<operationResultId></operationR<systemId>default</sy<staffId>5235436557655</st<staffName>張三</staffNam<deptId>85542432244</d<orgId>6653544365435</<addTime>2017-08-2316:32:43</a<batchId>batchId</b·DB52/T1261—2018C.3.1.3請(qǐng)求參數(shù)說(shuō)明表C.6參數(shù)表是是是否是是是是是是是是是是是是是是是是是是否否否否否否是參數(shù)名參數(shù)類型說(shuō)明否否備注字段1否備注字段2否備注字段3否否備注字段5否預(yù)留C.3.1.4響應(yīng)格式返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。C.3.1.5響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型說(shuō)明是是狀態(tài)信息,一般用來(lái)標(biāo)識(shí)錯(cuò)誤信息C.4統(tǒng)一消息提醒服務(wù)C.4.1消息提醒推送C.4.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:POST,請(qǐng)求地址:/api/base/message/push?sign=&token=。C.4.1.2請(qǐng)求包結(jié)構(gòu)體請(qǐng)求體為一個(gè)XML文檔,結(jié)構(gòu)如下。<notice-user>325435353464</noti<notice-user>325435353465</noti<notice-org>544645675</notiDB52/T1261—2018<notice-org>544645675</n<notice-department>54567586876</notice-<content-url>http://efdsafdsa</co<action-url>http://ret</<publish-user>張三</pu<publish-time>2014-12-0100:00:00</pu<expire-time>2014-12-0100:00:00</e<message>消息內(nèi)容可不能帶有HTML標(biāo)簽哦,最長(zhǎng)不要超過(guò)250個(gè)C.4.1.3請(qǐng)求參數(shù)說(shuō)明是是發(fā)布時(shí)間,立即發(fā)布的可以省略,否則為C.4.1.4響應(yīng)格式返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。C.4.1.5響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型是否必須說(shuō)明是是狀態(tài)信息,一般用來(lái)標(biāo)識(shí)錯(cuò)誤信息C.5統(tǒng)一參數(shù)服務(wù)C.5.1獲取系統(tǒng)參數(shù)請(qǐng)求方式:GET,請(qǐng)求地址:/api/base/param/getParam?sign=&token¶mkey=¶mtype=。C.5.1.2請(qǐng)求參數(shù)說(shuō)明參數(shù)名參數(shù)類型是否必須說(shuō)明是請(qǐng)求參數(shù)簽名是調(diào)用token憑證是是參數(shù)類型C.5.1.3響應(yīng)格式返回?cái)?shù)據(jù)是JSON格式的字符串,需要自行解析處理。示例格式如下。{"mesage":"成功",}DB52/T1261—2018C.5.1.4響應(yīng)格式說(shuō)明是是是C.6統(tǒng)一待辦服務(wù)C.6.1統(tǒng)一令牌服務(wù)C.6.1.1獲取token令牌C.請(qǐng)求說(shuō)明請(qǐng)求方式:GET,請(qǐng)求地址:/api/base/token/getToken?sign=。C.請(qǐng)求包結(jié)構(gòu)體請(qǐng)求包結(jié)構(gòu)體數(shù)據(jù)是XML格式的字符串,需要自行構(gòu)建處理。示例格式如下。<?xmlversion="1.0"encodin<client-time>2014-07-1012:23:32</c<key>aabbccddeeff001122C.請(qǐng)求參數(shù)說(shuō)明是是是是C.響應(yīng)格式返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理。示例格式如下。<?xmlversion="1.0"encodinC.響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型說(shuō)明是是狀態(tài)信息,一般用來(lái)標(biāo)識(shí)錯(cuò)誤信息是獲得的授權(quán)碼,這個(gè)授權(quán)碼可以在10分鐘內(nèi)使用。DB52/T1261—2018(規(guī)范性附錄)政務(wù)業(yè)務(wù)事項(xiàng)服務(wù)設(shè)計(jì)D.1臺(tái)賬信息服務(wù)設(shè)計(jì)D.1.1個(gè)人臺(tái)賬推送D.1.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:POST,請(qǐng)求地址:/api/gov/ledger/push?sign=&token=。D.1.1.2請(qǐng)求包結(jié)構(gòu)體返回?cái)?shù)據(jù)是JSON格式的字符串,需要自行解析處理,示例格式如下。{}D.1.1.3請(qǐng)求參數(shù)說(shuō)明參數(shù)名參數(shù)類型說(shuō)明是請(qǐng)求參數(shù)簽名是內(nèi)容的標(biāo)題,不能帶HTML標(biāo)簽,也不能臺(tái)賬內(nèi)容臺(tái)賬日期,臺(tái)賬屬于哪天的臺(tái)賬所屬人臺(tái)賬所屬人姓名臺(tái)賬創(chuàng)建人臺(tái)賬創(chuàng)建人姓名創(chuàng)建時(shí)間,必須是yyyy-mm-ddHH:ii:ss格式D.1.1.4響應(yīng)格式返回?cái)?shù)據(jù)是JSON格式的字符串,需要自行解析處理,示例格式如下。{DB52/T1261—2018D.1.1.5響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型是否必須說(shuō)明statusString是成功為ok,否則為errmessageString是狀態(tài)信息D.2通知公告服務(wù)設(shè)計(jì)D.2.1通知公告推送D.2.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:POST,請(qǐng)求地址:/api/gov/notice/push?sign=&token=。D.2.1.2請(qǐng)求包結(jié)構(gòu)體D.請(qǐng)求包內(nèi)容及其附件采用zip壓縮成一個(gè)壓縮包提交到數(shù)據(jù)服務(wù)器,實(shí)現(xiàn)數(shù)據(jù)推送.只要按照預(yù)定格式壓縮,一次可以推送多條信息。D.壓縮文件里必須擁有一個(gè)manifest.xml文件,這個(gè)文件用來(lái)描述推送信息要素。示例格式如下。<?xmlversion="1.0"encodin<require-receipt>1</requ<emergency-level>無(wú)</emerge<start-time>2017-08-1412:23:21</<end-time>2017-09-1412:23:21<encoding來(lái)標(biāo)識(shí)文件字符集,type來(lái)標(biāo)<contentfile="content.txt"encoding="utf-8"type="text<!--反饋提醒用戶ID,如果沒(méi)有,則不提醒--><feedback-remind-uid>22222222222</feedback-rem<!--審核人ID,沒(méi)有為不需要審核,目前僅支持一個(gè)審核人--><reviewer>342133141</rev<!--接收單位,可以有多個(gè)--><reciept-org>544645675</recie<reciept-org>544645675</recie<!--接收部門,在只發(fā)給某單位下一些特有的部門時(shí)使用,可以有多個(gè)--><reciept-department>54567586876</reciept-dep<!--接收人,只發(fā)給具體的人時(shí)使用,可以有多個(gè)--><reciept-user>325435353464</reciept-user><reciept-user>325435353465</reciept-<attachmentfile="attachment01.rar"title=“附件標(biāo)題”info="附件描<attachmentfile="attachment02.rar"title=“附件標(biāo)題”info="附件描述”>·DB52/T1261—2018是是notification表示一條通知公告,可以有多個(gè)的不同信息具有不同的標(biāo)識(shí),同一條信息必須一致,當(dāng)多次推同一個(gè)標(biāo)識(shí)的信息過(guò)來(lái)后,后面的會(huì)替換掉前面的信息.開始時(shí)間,必須是yyyy-mm-ddHH:i結(jié)束時(shí)間,必須是yyyy-mm-ddH接收部門,在只發(fā)給某單位下一些特有的部門時(shí)<contentfile="content.txt"encoding="utf-8"type="te<attachmentfile="attachment01.rar"title="附件標(biāo)題"inD.2.1.4響應(yīng)格式返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。<?xmlversion="1.0"encoding="UTF-8"?><documentguid="contentguid3"status="已發(fā)布"/>·D.2.1.5響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型是否必須說(shuō)明是是狀態(tài)信息,一般用來(lái)標(biāo)識(shí)錯(cuò)誤信息是只有status為ok時(shí),有這個(gè)結(jié)點(diǎn)是推送內(nèi)容的詳細(xì)處理結(jié)果。1.guid對(duì)應(yīng)推送內(nèi)容的guid,2.status為處理結(jié)果,一般處理結(jié)出錯(cuò),當(dāng)為出錯(cuò)時(shí),屬性message表示簡(jiǎn)單的出錯(cuò)信息DB52/T1261—2018D.3文檔轉(zhuǎn)換服務(wù)設(shè)計(jì)D.3.1文檔在線預(yù)覽D.3.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/docTrans/preview?sign=&token=&docurl=。D.3.1.2請(qǐng)求參數(shù)說(shuō)明是是是D.3.1.3響應(yīng)格式返回?cái)?shù)據(jù)是JSON格式的字符串,需要自行解析處理。示例格式如下。{}D.3.1.4響應(yīng)格式說(shuō)明是是是D.4門戶推送服務(wù)設(shè)計(jì)D.4.1查詢可推送欄目D.4.1.1請(qǐng)求說(shuō)明請(qǐng)求方式:GET,請(qǐng)求地址:/api/gov/portal/getcolumns?sign=&token=。D.4.1.2響應(yīng)格式返回?cái)?shù)據(jù)是XML格式的字符串,需要自行解析處理,示例格式如下。<?xmlversion="1.0"encoding="·D.4.1.3響應(yīng)格式說(shuō)明參數(shù)名參數(shù)類型說(shuō)明是是是是具體欄目是是DB52/T1261—2018D.4.2推送數(shù)據(jù)到欄目D.4.2.1請(qǐng)求說(shuō)明請(qǐng)求方式:POST,請(qǐng)求地址:/api/gov/portal/push?sign=&token=&sourceid=12&duplicate=ignore。D.4.2.2請(qǐng)求包結(jié)構(gòu)體提交過(guò)來(lái)的是一個(gè)壓縮文件,壓縮文件里必須擁有一個(gè)manifest.xml文件,這個(gè)文件用來(lái)描述推送信息要素,一個(gè)簡(jiǎn)單的manifest.xml文件示例格式如下。<?xmlversion="1.0"encodin<important-level>普通</import<link-url>/test/test.htm<datetime>2014-06-1412:23:21<encoding來(lái)標(biāo)識(shí)文件字符集,type來(lái)標(biāo)<contentfile="content.txt"encoding="utf-8"type="text<attachmentfile="attachment01.rar"title="附件標(biāo)題"info<attachmentfile="attachment02.rar"title="附件標(biāo)題"infoD.4.2.3請(qǐng)求參數(shù)說(shuō)明參數(shù)名參數(shù)類型說(shuō)明是請(qǐng)求參數(shù)簽名是是否用:ignore(忽略,默認(rèn)值),update(更新)這是推送信息文檔的根結(jié)點(diǎn)表示一條內(nèi)容信息,可以有多個(gè)document標(biāo)簽,實(shí)現(xiàn)一次性推送多條信息。內(nèi)容的標(biāo)題,不能帶HTML標(biāo)簽,也不能省略,信息唯一標(biāo)識(shí)符,長(zhǎng)度不超過(guò)16位的字母+數(shù)字組成的字符串,從同一個(gè)業(yè)務(wù)系統(tǒng)同的標(biāo)識(shí),同一條信息必須一致,當(dāng)多次推同一個(gè)標(biāo)識(shí)的信息過(guò)來(lái)后,后面的會(huì)替換掉前面的信息。重要級(jí)別,一般分為:普通,急件,特急,特提.可以省略,鏈接地址,一般用來(lái)直接到業(yè)務(wù)系統(tǒng)進(jìn)行訪問(wèn)的地址,通常情況下應(yīng)該是不時(shí)間,一般為發(fā)布時(shí)間,必須是yyyy-mm-ddHH:ii:這是通知公告內(nèi)容,可以帶HTML標(biāo)簽,也可以放在單獨(dú)的文
溫馨提示
- 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。
最新文檔
- 【語(yǔ)文課件】井岡翠竹 (鄂教版)課件
- 《基層醫(yī)院感染培訓(xùn)》課件
- 三年級(jí)寫作入門指導(dǎo)
- 平行和相交(黃玉紅的課件)
- 【大學(xué)課件】市場(chǎng)營(yíng)銷調(diào)研與預(yù)測(cè)
- 一步一步走啊走視頻專用課件
- 《第三節(jié) 合理發(fā)展交通運(yùn)輸》課件1
- 固定收益策略報(bào)告:資金下還是短端上
- 《導(dǎo)師孫名松教授》課件
- 單位管理制度展示大全【職工管理篇】十篇
- 小學(xué)生家長(zhǎng)教育焦慮調(diào)查問(wèn)卷
- 客服年終總結(jié)不足之處及改進(jìn)計(jì)劃(五篇)
- 錨桿支護(hù)質(zhì)量檢查驗(yàn)收表
- GB/T 17238-2008鮮、凍分割牛肉
- 神通數(shù)據(jù)庫(kù)管理系統(tǒng)v7.0企業(yè)版-2實(shí)施方案
- 人體內(nèi)臟器官結(jié)構(gòu)分布圖詳解
- 八年級(jí)上冊(cè)科學(xué)(浙教版)復(fù)習(xí)提綱
- 基金會(huì)項(xiàng)目基金捐贈(zèng)立項(xiàng)表
- OCT青光眼及視野報(bào)告
- 人音版小學(xué)音樂(lè)四年級(jí)下冊(cè)課程綱要
- 初中語(yǔ)文人教七年級(jí)上冊(cè)朝花夕拾學(xué)生導(dǎo)讀單
評(píng)論
0/150
提交評(píng)論