DB52T 1261-2018 政務(wù)云 貴州省電子政務(wù)網(wǎng) 應(yīng)用平臺接入規(guī)范

DB52DB52/T1261—2018政務(wù)云貴州省電子政務(wù)網(wǎng)應(yīng)用平臺接入規(guī)范貴州省質(zhì)量技術(shù)監(jiān)督局發(fā)布I 1 1 2 2 4 6 8 1政務(wù)云貴州省電子政務(wù)網(wǎng)應(yīng)用平臺接入規(guī)范本標(biāo)準(zhǔn)規(guī)定了貴州省電子政務(wù)網(wǎng)應(yīng)用平臺接入的基本要求、接入要求、運維管理要求。本標(biāo)準(zhǔn)適用于需要接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺的業(yè)務(wù)應(yīng)用系統(tǒng)。2術(shù)語和定義下列術(shù)語和定義適用于本文件。貴州省電子政務(wù)網(wǎng)貴州省電子政務(wù)網(wǎng)是由貴州省人民政府辦公廳牽頭統(tǒng)一建設(shè)的，面向全省各級政府及其部門，集協(xié)同工作、學(xué)習(xí)，加強(qiáng)內(nèi)部管理、交流等功能為一體的全省政府系統(tǒng)行政辦公總平臺及總?cè)肟?，是貴州省電子政務(wù)云的一個重要應(yīng)用平臺，其基于國家電子政務(wù)外網(wǎng)環(huán)境建設(shè)，功能定位主要是為全省政府系統(tǒng)公務(wù)人員提供信息資源共享、數(shù)據(jù)互聯(lián)互通和聯(lián)動辦公服務(wù)。政務(wù)服務(wù)開放平臺貴州省電子政務(wù)網(wǎng)應(yīng)用平臺中專用于為本標(biāo)準(zhǔn)規(guī)范所定義的業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)進(jìn)行管理的一個子系統(tǒng)。主要用于對需要接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺的業(yè)務(wù)應(yīng)用系統(tǒng)、服務(wù)、服務(wù)提供方、服務(wù)使用方等各種要素信息進(jìn)行流程化的管理維護(hù)。業(yè)務(wù)應(yīng)用系統(tǒng)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺中接入的各種解決政務(wù)業(yè)務(wù)需求的軟件系統(tǒng)。包括貴州省電子政務(wù)網(wǎng)應(yīng)用平臺中已有的基礎(chǔ)辦公系統(tǒng)、接入的其它第三方廠商軟件系統(tǒng)等，但不包括平臺底層支撐組件。服務(wù)接入的業(yè)務(wù)應(yīng)用系統(tǒng)中的某些功能利用技術(shù)接口的方式單獨提供出來供其它業(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ù)開放平臺中注冊并發(fā)布的組織或機(jī)構(gòu)。2.6服務(wù)使用方需要調(diào)用政務(wù)服務(wù)開放平臺上發(fā)布的服務(wù)或業(yè)務(wù)應(yīng)用系統(tǒng)的組織或機(jī)構(gòu)。2.7平臺運營方對貴州省電子政務(wù)網(wǎng)應(yīng)用平臺進(jìn)行運維和管理服務(wù)的組織或機(jī)構(gòu)。2.8業(yè)主單位在政務(wù)服務(wù)開放平臺中注冊的業(yè)務(wù)應(yīng)用系統(tǒng)的直接責(zé)任單位。3基本要求3.1業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)應(yīng)按4.4條進(jìn)行注冊。3.2業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)以貴州省電子政務(wù)網(wǎng)應(yīng)用平臺中的統(tǒng)一組織機(jī)構(gòu)人員數(shù)據(jù)庫作為基礎(chǔ)數(shù)據(jù)實現(xiàn)機(jī)構(gòu)人員數(shù)據(jù)共享。3.3業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)以貴州省電子政務(wù)網(wǎng)應(yīng)用平臺中的統(tǒng)一認(rèn)證系統(tǒng)作為身份認(rè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)用平臺推送操作日志、提醒消息、待辦事項等與工作相關(guān)的人員行為數(shù)據(jù)信息。3.5服務(wù)提供方及業(yè)主單位應(yīng)規(guī)范運維和管理接入的業(yè)務(wù)應(yīng)用系統(tǒng)和服務(wù)，確保正常運行，不得影響到貴州省電子政務(wù)網(wǎng)應(yīng)用平臺的正常運轉(zhuǎn)。4接入要求4.1接入網(wǎng)絡(luò)要求貴州省電子政務(wù)網(wǎng)應(yīng)用平臺運行于國家電子政務(wù)外網(wǎng)，業(yè)務(wù)應(yīng)用系統(tǒng)接入貴州省電子政務(wù)網(wǎng)應(yīng)用平臺應(yīng)通過國家電子政務(wù)外網(wǎng)環(huán)境進(jìn)行接入。4.2接入技術(shù)要求4.2.1服務(wù)提供方在提供服務(wù)技術(shù)接口時，應(yīng)遵行以下接口要求：a)服務(wù)接口要求支持XML和JSON數(shù)據(jù)格式。XML遵行XML1.0第5版規(guī)范，JSON遵行RFC4627規(guī)范；并要求支持JAVA、PHP、Javascript、.NET等主流開發(fā)語言；b)服務(wù)接口要求支持SDK或API模式，并支持WebService或Restful兩種接口方式，同時提供詳細(xì)接口技術(shù)文檔。34.2.2業(yè)務(wù)應(yīng)用系統(tǒng)應(yīng)兼容支持HTML5標(biāo)準(zhǔn)規(guī)范的現(xiàn)代瀏覽器，移動端應(yīng)支持Android4.流程4DB52/T1261—20184.4.2服務(wù)提供方注冊流程服務(wù)提供方完整填寫《業(yè)務(wù)系統(tǒng)注冊基本信息表》（見附錄A.1相關(guān)人員單位簽字用章后，提交給政務(wù)服務(wù)開放平臺管理人員。政務(wù)服務(wù)開放平臺管理人員負(fù)責(zé)審批服務(wù)提供方提交業(yè)務(wù)系統(tǒng)注冊基本信息，審批通過后配發(fā)業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人的登錄賬號密碼給服務(wù)提供方的業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人。業(yè)務(wù)應(yīng)用系統(tǒng)負(fù)責(zé)人通過賬號密碼登錄到政務(wù)服務(wù)開放平臺進(jìn)行后續(xù)操作。4.4.3服務(wù)提供方申請發(fā)布服務(wù)流程業(yè)務(wù)應(yīng)用系統(tǒng)注冊基本信息審批通過后，服務(wù)提供方才可以進(jìn)行申請發(fā)布服務(wù)的流程。服務(wù)提供方完整填寫《服務(wù)發(fā)布申請基本信息表》（見附錄A.2相關(guān)人員單位簽字用章后，提交給政務(wù)服務(wù)開放平臺管理人員，審批通過后可在政務(wù)服務(wù)開放平臺中發(fā)布該服務(wù)。要發(fā)布的服務(wù)的每一個服務(wù)接口都需要單獨填寫一份《服務(wù)接口內(nèi)容信息表》（見附錄A.3提交給政務(wù)服務(wù)開放平臺管理人員。4.4.4服務(wù)使用方申請使用業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)流程申請業(yè)務(wù)應(yīng)用系統(tǒng)使用時，完整填寫《業(yè)務(wù)應(yīng)用系統(tǒng)使用申請基本信息表》（見附錄A.5）,提交給政務(wù)服務(wù)開放平臺管理人員，審批通過后將由業(yè)務(wù)應(yīng)用系統(tǒng)的服務(wù)提供方與申請單位聯(lián)系后續(xù)開通使用事宜。申請使用服務(wù)時，完整填寫《服務(wù)使用申請基本信息表》（見附錄A.4提交給政務(wù)服務(wù)開放平臺管理人員，審批通過后申請方按相關(guān)技術(shù)規(guī)范使用，使用過程中的技術(shù)問題由該服務(wù)的服務(wù)提供方提供支持。4.5接入技術(shù)規(guī)范4.5.1業(yè)務(wù)應(yīng)用系統(tǒng)在調(diào)用服務(wù)接口時，應(yīng)先進(jìn)行身份鑒權(quán)，接口鑒權(quán)規(guī)范見附錄B。4.5.2貴州省電子政務(wù)網(wǎng)平臺已提供的“基礎(chǔ)通用服務(wù)”類別的接口描述與技術(shù)規(guī)范見附錄C。4.5.3貴州省電子政務(wù)網(wǎng)平臺已提供的“政務(wù)業(yè)務(wù)事項服務(wù)”類別的接口描述與技術(shù)規(guī)范見附錄D。4.5.4接口返回代碼規(guī)范與對照表見附錄E。4.5.5服務(wù)提供方在發(fā)布其它服務(wù)時的設(shè)計規(guī)范見附錄F。5運維管理要求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)用平臺進(jìn)行審批并承擔(dān)相應(yīng)管理責(zé)任。5.1.2業(yè)主單位負(fù)責(zé)協(xié)調(diào)所選取的業(yè)務(wù)應(yīng)用系統(tǒng)的服務(wù)提供方與平臺運營方的對接工作。5.1.3業(yè)主單位應(yīng)為本單位接入的業(yè)務(wù)應(yīng)用系統(tǒng)制定相應(yīng)的運維策略與安全策略，并確保正常執(zhí)行。5.2服務(wù)提供方管理要求5.2.1服務(wù)提供方應(yīng)為業(yè)務(wù)應(yīng)用系統(tǒng)指定負(fù)責(zé)人，負(fù)責(zé)與平臺運營方進(jìn)行對接，并承擔(dān)管理責(zé)任。5.2.2服務(wù)提供方應(yīng)按規(guī)范提供業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)，并保障其正常穩(wěn)定的運行于貴州省電子政務(wù)網(wǎng)應(yīng)用平臺之上。5.2.3服務(wù)提供方負(fù)責(zé)提供接入的業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)的技術(shù)支持和運維服務(wù)。55.2.4服務(wù)提供方應(yīng)為接入的每一個業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)均提供測試報告，配合平臺運營方的要求做聯(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)開放平臺相關(guān)要求規(guī)范使用業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)。5.3.2在使用服務(wù)過程中如發(fā)現(xiàn)缺陷或需要改進(jìn)的地方，應(yīng)主動與平臺運營方進(jìn)行溝通。5.4平臺運營方管理要求5.4.1負(fù)責(zé)貴州省電子政務(wù)網(wǎng)應(yīng)用平臺業(yè)務(wù)應(yīng)用系統(tǒng)及服務(wù)接入的日常管理與技術(shù)支持。5.4.2負(fù)責(zé)平臺基礎(chǔ)通用服務(wù)和政務(wù)業(yè)務(wù)事項服務(wù)技術(shù)接口的維護(hù)更新與缺陷修正。5.5應(yīng)急處置5.5.1業(yè)務(wù)應(yīng)用系統(tǒng)或服務(wù)發(fā)生嚴(yán)重故障時，如影響到貴州省電子政務(wù)網(wǎng)應(yīng)用平臺或其它業(yè)務(wù)應(yīng)用系統(tǒng)的正常運行時，平臺運營方有權(quán)要求暫停該系統(tǒng)和服務(wù)，直到整改正常方可申請恢復(fù)。6DB52/T1261—2018（規(guī)范性附錄）接入管理流程相關(guān)信息表A.1業(yè)務(wù)系統(tǒng)注冊基本信息表表A.1業(yè)務(wù)系統(tǒng)注冊基本信息表A.2服務(wù)使用申請基本信息表表A.2服務(wù)使用申請基本信息表7廠商名稱：廠商系統(tǒng)標(biāo)識：已接入業(yè)務(wù)系統(tǒng)：業(yè)務(wù)系統(tǒng)負(fù)責(zé)人：聯(lián)系電話：聯(lián)系郵箱：申請發(fā)布的服務(wù)類別和名稱：申請?zhí)峁┰颍悍?wù)廠商負(fù)責(zé)人簽名：業(yè)主單位聯(lián)系人簽名：服務(wù)廠商用章：業(yè)主單位用章：服務(wù)接口名稱：服務(wù)接口URL:所屬業(yè)務(wù)系統(tǒng)：數(shù)據(jù)標(biāo)準(zhǔn)說明：在線測試結(jié)果：申請單位名稱：聯(lián)系人：8DB52/T1261—2018（規(guī)范性附錄）接口鑒權(quán)規(guī)范B.1接口簽名使用規(guī)范B.1.1待簽名的字符串在請求參數(shù)列表中，除去sign簽名和token令牌參數(shù)外，其他需要使用到的參數(shù)都是需要簽名的參數(shù)，相關(guān)要求如下：a)對于參數(shù)排序要求是按a到z的順序排序；b)參數(shù)統(tǒng)一使用小寫字母方式；c)若參數(shù)存在多層結(jié)構(gòu)，只取第一層進(jìn)行簽名；d)若參數(shù)沒有值，無需包含到簽名數(shù)據(jù)列表中；e)根據(jù)HTTP協(xié)議要求,傳遞參數(shù)的值中如果存在特殊字符(如:&、@等),那么該值需要做URLEncoding；f)待簽名數(shù)據(jù)應(yīng)該是原生值而不是encoding之后的值。注：調(diào)用某接口需要對請求參數(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ù)字組成的32位字符串。B.1.3.2當(dāng)拿到請求時的待簽名字符串后,需要把私鑰直接拼接到待簽名字符串的后面,形成新的字符串,利用SM3加密函數(shù)對這個新的字符串進(jìn)行簽名運算,從而得到簽名結(jié)果字符串(該字符串賦值于參數(shù)sign)，并將簽名結(jié)果字符串全部字母轉(zhuǎn)換為小寫字母。9B.2令牌使用規(guī)范使用基于Token的身份驗證方法，大概的流程是這樣的：a)客戶端使用用戶名跟密碼請求登錄；b)服務(wù)端收到請求，去驗證用戶名與密碼；串)簽發(fā)一個Token,再把這個Token發(fā)送給客戶端；d)客戶端收到Token以后可以把它存儲起來，比如放在Cookie里；e)客戶端每次向服務(wù)端請求資源的時候需要帶著服務(wù)端簽發(fā)的Token,服務(wù)端收到請求，然后去驗證客戶端請求里面帶著的Token,如果驗證成功，就向客戶端返回請求的數(shù)據(jù)。B.3IP鑒權(quán)機(jī)制廠商在政務(wù)開放平臺注冊成功后，在調(diào)用接口前，都需要提供來訪的應(yīng)用IP地址，用于在服務(wù)調(diào)用前進(jìn)行IP鑒權(quán)，鑒權(quán)成功后，服務(wù)接口才會響應(yīng)請求，對于使用負(fù)載均衡或無法提供固定應(yīng)用IP的應(yīng)用，可以提交申請，告知開放平臺對特定應(yīng)用取消IP鑒權(quán)。B.4登錄安全規(guī)范B.4.1登錄認(rèn)證時所需要的參數(shù)說明見表B.1。說明字符串字符串字符串返回登錄信息字符串，多個字段以“,”分割。所有字段名全部小寫字符串字符串排除過濾路徑的資源，主要用于不需要進(jìn)行認(rèn)證就可以資源的訪問，支持目錄和指定后綴的模糊配置字符串系統(tǒng)推出后的通知接收URL,后臺認(rèn)證的多個系統(tǒng)中的任一系統(tǒng)推出后，系統(tǒng)會往成功登陸的其它系統(tǒng)發(fā)送消息，以實現(xiàn)單點退出功能。字符串(16位)個系統(tǒng)分配唯一一個Key,為了安全不能外傳。字符串DB52/T1261—2018B.4.2參數(shù)加密說明登錄會對關(guān)鍵參數(shù)采用SM4加密，先加密得到二進(jìn)制串，然后將二進(jìn)制傳轉(zhuǎn)換為16進(jìn)制字符串進(jìn)行傳遞，傳遞到服務(wù)端后系統(tǒng)根據(jù)系統(tǒng)ID獲取對應(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語言舉例如下。示例：remoteLogin(Stringsys參數(shù)說明見表B.2。表B.2參數(shù)表表C.1參數(shù)表參數(shù)名參數(shù)類型必須說明是請求參數(shù)簽名是是是否應(yīng)用系統(tǒng)ID,可為空，如果為空則取視圖表設(shè)置的業(yè)務(wù)系統(tǒng)數(shù)據(jù)，如果視圖是主要是用取單位從這個時間起到當(dāng)前為止，有變動的數(shù)據(jù)是主要是用取部門從這個時間起到當(dāng)前為止，有變動的數(shù)據(jù)是主要是用取人員從這個時間起到當(dāng)前為止，有變動的數(shù)據(jù)是主要是用取身份從這個時間起到當(dāng)前為止，有變動的數(shù)據(jù)是獲取數(shù)據(jù)類型，0取所有更新數(shù)據(jù)1只取單位更新數(shù)據(jù)2只取部門更新數(shù)據(jù)3只取人員更新數(shù)據(jù)4只取人員身份更新數(shù)據(jù)否否是用戶ID,主要用記錄是哪個用戶發(fā)過來的請是DB52/T1261—2018C.1.1.4響應(yīng)數(shù)據(jù)解析說明返回數(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：是單位變動信息，countrows為獲取單位數(shù)據(jù)總記錄數(shù)，loopcou將要循環(huán)向平臺取單位實際數(shù)據(jù)的次數(shù)，lastdatetime是指單位數(shù)據(jù)更新最后時間，返回給客戶端供下次調(diào)C.1.2服務(wù)動作C.1.2.1人員批量同步C.服務(wù)描述提供給第三方開發(fā)商，用于批量獲取人員數(shù)據(jù)，批量獲取的數(shù)據(jù)支持分頁獲取，每頁返回最大行數(shù)不能超過100條，系統(tǒng)會默認(rèn)返回頁碼數(shù)，記錄總行數(shù)、以及相關(guān)頁的數(shù)據(jù)明細(xì)。C.服務(wù)地址請求方式：GET,請求地址：/api/gov/org/getUserData?sign=&token=。C.請求參數(shù)說明參數(shù)名必須說明是請求參數(shù)簽名是是的認(rèn)證用戶名。不能為空。是分配的用戶密碼，密碼傳遞SM3加密后的字符串否查詢數(shù)據(jù)頁碼，不傳默認(rèn)獲取第一頁的數(shù)據(jù)否DB52/T1261—2018C.返回數(shù)據(jù)返回數(shù)據(jù)是一個XML格式的字符串，需要自行解析，示例格式如下。<?xmlversion="1.0"encodin<recordcount>記錄總數(shù)</<pagecount>總頁數(shù)</pagecount><pagesize>每頁記錄數(shù)</pagesize><orgsystemtype=“1”orgid=””數(shù)據(jù)類型用戶KEYID人員姓名人員編號身份證號登錄賬號登錄別名手機(jī)1手機(jī)2國產(chǎn)密碼SM33性別出生日期民族ID3是否為單位管理員1應(yīng)用系統(tǒng)ID串人員類型學(xué)歷是否政協(xié)委員333是否本單位領(lǐng)導(dǎo)3啟用標(biāo)記創(chuàng)建時間最后修改時間DB52/T1261—2018C.1.3機(jī)構(gòu)批量同步C.1.3.1服務(wù)描述提供給第三方開發(fā)商，用于批量獲取機(jī)構(gòu)數(shù)據(jù)，批量獲取的數(shù)據(jù)支持分頁獲取，每頁返回最大行數(shù)不能超過2000條，系統(tǒng)會默認(rèn)返回頁碼數(shù)，記錄總行數(shù)、以及相關(guān)頁的數(shù)據(jù)明細(xì)。C.1.3.2服務(wù)地址請求方式：GET，請求地址：/api/gov/org/getOrgData?sign=&token=。C.1.3.3請求參數(shù)說明表C.3參數(shù)表是是是認(rèn)證用戶名，每個業(yè)務(wù)系統(tǒng)接入都會分配一個獨是否否<?xmlversion="1.0"encoding="UTF-8"<recordcount>記錄總數(shù)</recordcount><pagecount>總頁數(shù)</pagecount><pagesize>每頁記錄數(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)的界面，首先要通過系統(tǒng)驗證，系統(tǒng)會先生成隨機(jī)碼，隨機(jī)碼只能使用一次，使用后自動作廢。C.1.4.2服務(wù)地址請求方式：GET,請求地址：/api/gov/org/getSelectUser?sigC.1.4.3請求參數(shù)說明表C.4參數(shù)表參數(shù)名參數(shù)類型必須說明是請求參數(shù)簽名是是獨立的認(rèn)證用戶名。不能為空。是分配的用戶密碼，密碼傳遞SM3加密后的字符串否1、返回機(jī)構(gòu)人員選擇界面注：如果傳入?yún)?shù)為空默認(rèn)為1C.1.4.4返回數(shù)據(jù)返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。C.2統(tǒng)一認(rèn)證服務(wù)設(shè)計C.2.1遠(yuǎn)程系統(tǒng)登錄驗證C.2.1.1服務(wù)描述提供給第三方開發(fā)商，提供給第三方調(diào)用，進(jìn)行用戶密碼認(rèn)證，認(rèn)證需要調(diào)用客戶端的API方法進(jìn)行驗證，系統(tǒng)會對驗證過程中的用戶名密碼等相關(guān)參數(shù)進(jìn)行簽名和命名重寫，保證傳輸過程中的數(shù)據(jù)安全，安全規(guī)則遵行本標(biāo)準(zhǔn)附錄B.4登錄安全規(guī)范執(zhí)行。統(tǒng)一認(rèn)證支持自定義登錄頁面，指的是業(yè)務(wù)系統(tǒng)采用自己的登錄界面，與后端認(rèn)證服務(wù)器進(jìn)行通信進(jìn)行認(rèn)證和創(chuàng)建票據(jù)。自定義登錄頁面的認(rèn)證過程和統(tǒng)一認(rèn)證登錄界面的認(rèn)證過程一樣，業(yè)務(wù)系統(tǒng)需要調(diào)用SDK包中的客戶端認(rèn)證方法即可。DB52/T1261—2018C.2.1.2服務(wù)地址請求方式：GET，請求地址：/api/gov/org/remoteLogin?sign=&token=。C.2.1.3請求參數(shù)說明表C.5參數(shù)表是是是是是C.2.1.4返回數(shù)據(jù)返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。<?xmlversion="1.0"encodinC.3統(tǒng)一日志服務(wù)C.3.1日志信息推送C.3.1.1請求說明請求方式：POST，請求地址：/api/base/log/push?sign=&token=。C.3.1.2請求包結(jié)構(gòu)體請求包結(jié)構(gòu)體數(shù)據(jù)是XML格式的字符串，示例格式如下。<?xmlversion="1.0"encoding="UTF-8"<mainOId>5235436557655</ma<operationType>修改臺帳</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請求參數(shù)說明表C.6參數(shù)表是是是否是是是是是是是是是是是是是是是是是是否否否否否否是參數(shù)名參數(shù)類型說明否否備注字段1否備注字段2否備注字段3否否備注字段5否預(yù)留C.3.1.4響應(yīng)格式返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。C.3.1.5響應(yīng)格式說明參數(shù)名參數(shù)類型說明是是狀態(tài)信息，一般用來標(biāo)識錯誤信息C.4統(tǒng)一消息提醒服務(wù)C.4.1消息提醒推送C.4.1.1請求說明請求方式：POST,請求地址：/api/base/message/push?sign=&token=。C.4.1.2請求包結(jié)構(gòu)體請求體為一個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)簽哦,最長不要超過250個C.4.1.3請求參數(shù)說明是是發(fā)布時間,立即發(fā)布的可以省略,否則為C.4.1.4響應(yīng)格式返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。C.4.1.5響應(yīng)格式說明參數(shù)名參數(shù)類型是否必須說明是是狀態(tài)信息，一般用來標(biāo)識錯誤信息C.5統(tǒng)一參數(shù)服務(wù)C.5.1獲取系統(tǒng)參數(shù)請求方式：GET,請求地址：/api/base/param/getParam?sign=&token¶mkey=¶mtype=。C.5.1.2請求參數(shù)說明參數(shù)名參數(shù)類型是否必須說明是請求參數(shù)簽名是調(diào)用token憑證是是參數(shù)類型C.5.1.3響應(yīng)格式返回數(shù)據(jù)是JSON格式的字符串，需要自行解析處理。示例格式如下。{"mesage":"成功",}DB52/T1261—2018C.5.1.4響應(yīng)格式說明是是是C.6統(tǒng)一待辦服務(wù)C.6.1統(tǒng)一令牌服務(wù)C.6.1.1獲取token令牌C.請求說明請求方式：GET，請求地址：/api/base/token/getToken?sign=。C.請求包結(jié)構(gòu)體請求包結(jié)構(gòu)體數(shù)據(jù)是XML格式的字符串，需要自行構(gòu)建處理。示例格式如下。<?xmlversion="1.0"encodin<client-time>2014-07-1012:23:32</c<key>aabbccddeeff001122C.請求參數(shù)說明是是是是C.響應(yīng)格式返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理。示例格式如下。<?xmlversion="1.0"encodinC.響應(yīng)格式說明參數(shù)名參數(shù)類型說明是是狀態(tài)信息，一般用來標(biāo)識錯誤信息是獲得的授權(quán)碼，這個授權(quán)碼可以在10分鐘內(nèi)使用。DB52/T1261—2018（規(guī)范性附錄）政務(wù)業(yè)務(wù)事項服務(wù)設(shè)計D.1臺賬信息服務(wù)設(shè)計D.1.1個人臺賬推送D.1.1.1請求說明請求方式：POST，請求地址：/api/gov/ledger/push?sign=&token=。D.1.1.2請求包結(jié)構(gòu)體返回數(shù)據(jù)是JSON格式的字符串，需要自行解析處理，示例格式如下。{}D.1.1.3請求參數(shù)說明參數(shù)名參數(shù)類型說明是請求參數(shù)簽名是內(nèi)容的標(biāo)題，不能帶HTML標(biāo)簽，也不能臺賬內(nèi)容臺賬日期，臺賬屬于哪天的臺賬所屬人臺賬所屬人姓名臺賬創(chuàng)建人臺賬創(chuàng)建人姓名創(chuàng)建時間，必須是yyyy-mm-ddHH:ii:ss格式D.1.1.4響應(yīng)格式返回數(shù)據(jù)是JSON格式的字符串，需要自行解析處理，示例格式如下。{DB52/T1261—2018D.1.1.5響應(yīng)格式說明參數(shù)名參數(shù)類型是否必須說明statusString是成功為ok,否則為errmessageString是狀態(tài)信息D.2通知公告服務(wù)設(shè)計D.2.1通知公告推送D.2.1.1請求說明請求方式：POST，請求地址：/api/gov/notice/push?sign=&token=。D.2.1.2請求包結(jié)構(gòu)體D.請求包內(nèi)容及其附件采用zip壓縮成一個壓縮包提交到數(shù)據(jù)服務(wù)器,實現(xiàn)數(shù)據(jù)推送.只要按照預(yù)定格式壓縮,一次可以推送多條信息。D.壓縮文件里必須擁有一個manifest.xml文件,這個文件用來描述推送信息要素。示例格式如下。<?xmlversion="1.0"encodin<require-receipt>1</requ<emergency-level>無</emerge<start-time>2017-08-1412:23:21</<end-time>2017-09-1412:23:21<encoding來標(biāo)識文件字符集,type來標(biāo)<contentfile="content.txt"encoding="utf-8"type="text<!--反饋提醒用戶ID,如果沒有，則不提醒--><feedback-remind-uid>22222222222</feedback-rem<!--審核人ID,沒有為不需要審核，目前僅支持一個審核人--><reviewer>342133141</rev<!--接收單位，可以有多個--><reciept-org>544645675</recie<reciept-org>544645675</recie<!--接收部門，在只發(fā)給某單位下一些特有的部門時使用，可以有多個--><reciept-department>54567586876</reciept-dep<!--接收人，只發(fā)給具體的人時使用，可以有多個--><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表示一條通知公告,可以有多個的不同信息具有不同的標(biāo)識,同一條信息必須一致,當(dāng)多次推同一個標(biāo)識的信息過來后,后面的會替換掉前面的信息.開始時間，必須是yyyy-mm-ddHH:i結(jié)束時間，必須是yyyy-mm-ddH接收部門，在只發(fā)給某單位下一些特有的部門時<contentfile="content.txt"encoding="utf-8"type="te<attachmentfile="attachment01.rar"title="附件標(biāo)題"inD.2.1.4響應(yīng)格式返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。<?xmlversion="1.0"encoding="UTF-8"?><documentguid="contentguid3"status="已發(fā)布"/>·D.2.1.5響應(yīng)格式說明參數(shù)名參數(shù)類型是否必須說明是是狀態(tài)信息，一般用來標(biāo)識錯誤信息是只有status為ok時，有這個結(jié)點是推送內(nèi)容的詳細(xì)處理結(jié)果。1.guid對應(yīng)推送內(nèi)容的guid,2.status為處理結(jié)果，一般處理結(jié)出錯，當(dāng)為出錯時，屬性message表示簡單的出錯信息DB52/T1261—2018D.3文檔轉(zhuǎn)換服務(wù)設(shè)計D.3.1文檔在線預(yù)覽D.3.1.1請求說明請求方式：GET，請求地址：/api/gov/docTrans/preview?sign=&token=&docurl＝。D.3.1.2請求參數(shù)說明是是是D.3.1.3響應(yīng)格式返回數(shù)據(jù)是JSON格式的字符串，需要自行解析處理。示例格式如下。{}D.3.1.4響應(yīng)格式說明是是是D.4門戶推送服務(wù)設(shè)計D.4.1查詢可推送欄目D.4.1.1請求說明請求方式：GET,請求地址：/api/gov/portal/getcolumns?sign=&token=。D.4.1.2響應(yīng)格式返回數(shù)據(jù)是XML格式的字符串，需要自行解析處理，示例格式如下。<?xmlversion="1.0"encoding="·D.4.1.3響應(yīng)格式說明參數(shù)名參數(shù)類型說明是是是是具體欄目是是DB52/T1261—2018D.4.2推送數(shù)據(jù)到欄目D.4.2.1請求說明請求方式：POST，請求地址：/api/gov/portal/push?sign=&token=&sourceid=12&duplicate=ignore。D.4.2.2請求包結(jié)構(gòu)體提交過來的是一個壓縮文件，壓縮文件里必須擁有一個manifest.xml文件,這個文件用來描述推送信息要素，一個簡單的manifest.xml文件示例格式如下。<?xmlversion="1.0"encodin<important-level>普通</import<link-url>/test/test.htm<datetime>2014-06-1412:23:21<encoding來標(biāo)識文件字符集,type來標(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請求參數(shù)說明參數(shù)名參數(shù)類型說明是請求參數(shù)簽名是是否用：ignore(忽略，默認(rèn)值),update(更新)這是推送信息文檔的根結(jié)點表示一條內(nèi)容信息，可以有多個document標(biāo)簽，實現(xiàn)一次性推送多條信息。內(nèi)容的標(biāo)題，不能帶HTML標(biāo)簽，也不能省略，信息唯一標(biāo)識符，長度不超過16位的字母+數(shù)字組成的字符串，從同一個業(yè)務(wù)系統(tǒng)同的標(biāo)識，同一條信息必須一致，當(dāng)多次推同一個標(biāo)識的信息過來后，后面的會替換掉前面的信息。重要級別，一般分為：普通，急件，特急，特提.可以省略，鏈接地址，一般用來直接到業(yè)務(wù)系統(tǒng)進(jìn)行訪問的地址，通常情況下應(yīng)該是不時間，一般為發(fā)布時間，必須是yyyy-mm-ddHH:ii:這是通知公告內(nèi)容，可以帶HTML標(biāo)簽，也可以放在單獨的文