ICS 35.240.99CCSL67

DB42湖 北 省 地 方 標 準DB42/T1728.1—20211SpecificationforgovernmentservicemobileterminalconstructionSpecificationforgovernmentservicemobileterminalconstructionPart1:Applicationaccess2021080620211006湖北省市場監(jiān)督管理局發(fā)布目 次前言 III引言 IV1范引文件 1語定義 1匯接概述 2系總接架構 2鄂辦放臺定位 2應資服平能定位 3應接方式 3總流程 3應接申請 4接封和用發(fā) 4應上、核布 5接性要求 5接可性求 5口接 5接對流程 5接接申、核 6接注、調(diào) 6接發(fā)、用 7用發(fā) 8應接前備 8應接申請 8應接審核 9應開發(fā) 9用接入 9用傳核發(fā)布 11應上部署 11應審核 11應灰發(fā)布 11應正上線 11應更與線 11用入核準 11應可性 11應易性 12應接安性 12結數(shù)準性 13應系穩(wěn)性 13應兼性 13應抗性 13文完性 13用入全 13身鑒別 13訪控制 13審日志 14數(shù)安全 14代安全 14通安性 15惡行防范 15附錄A（范）接申請表 17附錄B（范）鄂辦開平接說明 19附錄D（范）接清單 29參考獻 30附錄C（料附錄D（范）接清單 29參考獻 30前 言本文件按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件是DB42/T1728《政務服務移動端建設規(guī)范》的第1部分。DB42/T1728已經(jīng)發(fā)布了以下部分：——第1部分：應用接入；——第2部分：旗艦店建設。本文件由湖北省大數(shù)據(jù)中心提出。本文件由湖北省政務管理辦公室歸口。本文件起草單位：湖北省大數(shù)據(jù)中心、湖北省標準化與質(zhì)量研究院、湖北省楚天云有限公司。本文件實施應用中的疑問，可咨詢湖北省政務管理辦公室，聯(lián)系電話郵箱：szwbjy@；對本文件的有關修改意見建議請反饋至湖北省大數(shù)據(jù)中心，聯(lián)系電話郵箱：342718797@。引 言州提高網(wǎng)上政務服務能力和方便群眾辦事的目的，加快建設全省統(tǒng)一政務服務移動端成為重要任務。DB42/T1728.1-2021第1部分：應用接入。目的在于確立第三方應用接入政務服務移動端的要求和操作規(guī)范。第2部分：旗艦店建設。目的在于統(tǒng)一各級鄂匯辦旗艦店的建設風格和功能要求。政務服務移動端建設規(guī)范第1部分：應用接入范圍本文件適用于全省各級政府部門政務服務應用（以下簡稱政務服務應用）與鄂匯辦的對接。（DB42/T1728.2-2021政務服務移動端建設規(guī)范第2部分：旗艦店建設3術語和定義3術語和定義下列術語和定義適用于本文件。3.1政務服務移動端E-Huibanmobileplatform由APP、微信小程序、支付寶小程序等移動端應用組成。以下簡稱“鄂匯辦”。3.2APPE-HuibanAPP由湖北省人民政府主辦，集政務服務、政務公開、便民服務、政民互動為一體的綜合服務平臺。3.3鄂匯辦開放平臺E-Huibangovernmentopenplatform鄂匯辦與接入單位對接的接入平臺。接入方與鄂匯辦接入通過鄂匯辦開放平臺統(tǒng)一接入。3.4應用資源服務平臺applicationresourceserviceplatformAPP3.5接入單位accessorganization3.6政務服務應用governmentaffairsserviceapplication由各級政府部門為自然人，法人和其他組織提供各類政務服務的應用。以下簡稱“應用”?？傮w接入架構示意圖見圖1。圖1系統(tǒng)總體接入架構示意圖圖1系統(tǒng)總體接入架構示意圖鄂匯辦開放平臺承擔以下功能和服務。urltoken、appid、appsecrettoken、appIdappSecrect：JVMApache，Tomcat1。表1應用資源服務平臺支持的運行環(huán)境支持應用類型中間件中間件版本描述頁面應用Nginx1.12+頁面應用，提供Nginx運行環(huán)境頁面應用Apache2.4+ApacheJava應用JDK1.8+Java應用，提供JDK運行環(huán)境JavaWeb應用Tomcat7.0+WEBTomcat應用接入內(nèi)容如下：應用接入方式如下。APPAPPHTTPHTTPSHTTPWebServicesWebServicesSOAPAPP。圖2應用接入總體流程示意圖圖2應用接入總體流程示意圖DB42/T1728.2-2021接入方的服務接口應滿足表2的要求。表2接口接入要求接口類型指標要求一般接入接口并發(fā)數(shù)支持>1000響應時間99%請求<2秒用戶訪問量高的高頻接口并發(fā)數(shù)支持>2000響應時間99%請求<3秒4.10接口可用性要求4.10接口可用性要求）99.9%。5接口對接圖3接口對接流程A.1B4B.6Number（），Json，Array（）ParameterPath（），Name=張某（請求體中以application/json格式），Body(請求體中以x-www-form-urlencoded格式)；網(wǎng)絡連通性校驗，鄂匯辦開放平臺使用以上填寫的接口地址、請求方式、響應數(shù)據(jù)格式、request（API（圖4接口注冊、聯(lián)調(diào)流程接口發(fā)布、調(diào)用流程基本要求如下。appKeyappSecretso如圖5所示，接口發(fā)布、調(diào)用流程如下：接口發(fā)布：通過校驗、可用性審核的API具有發(fā)布資格，反之攔截接口發(fā)布請求，發(fā)布HTTP:8060/，HTTPS::40443/（http://hbzw-gateway-a9854343a11a1）；圖5接口發(fā)布、調(diào)用流程6應用開發(fā)圖5接口發(fā)布、調(diào)用流程6應用開發(fā)接入方應填寫可接入應用，并在提交應用申請前完成支撐應用所需要的接口開發(fā)，相關示例見附錄C。申請?zhí)顚憙?nèi)容及要求如下。D.1）（用場景，預估覆蓋的人群數(shù)量、使用的頻次，過往的業(yè)務量等信息。示例：服務名稱服務對象服務主體（所屬單位）核心業(yè)務流程業(yè)務詳細描述預估使用人數(shù)/年過往1年的業(yè)務量社?？ㄅR時掛失個人湖北省人力資源與社會保障廳居民輸入需要辦理臨時掛失的社?？ㄌ枴c擊申請臨時掛失——申請成功居民持有的社?？ㄟz失后，可使用本服務進行社?？ǖ呐R時掛失，防止被他人盜刷。若臨時掛失后找回社保卡，還可以通過解除掛失服務恢復正常使用。100萬人/年130萬人次接入方申請上線的應用至少需滿足以下幾個條件方能通過審核。DB42/T1728.2-2021DB42/T1728.2-2021UI56.5.3用戶對接流程包括：SDK用戶對接時需先引入政務服務應用接入鄂匯辦APP標準規(guī)范的腳本文件地址。示例：<scripttype="text/javascript"src="JSSDK所在網(wǎng)絡url"></script><scripttype="text/javascript"src="JSSDK所在網(wǎng)絡url"></script>6.5.5用戶登錄執(zhí)行用戶登錄操作時，應執(zhí)行以下示例中的函數(shù)。6.5.5用戶登錄執(zhí)行用戶登錄操作時，應執(zhí)行以下示例中的函數(shù)。示例：6.5.6用戶注銷注銷鄂匯辦APP已登錄用戶應按以下示例執(zhí)行。示例：6.5.4獲取用戶加密數(shù)據(jù)在使用時應用或事項應獲取用戶加密數(shù)據(jù)，得到返回值。示例：獲取方法:獲取方法:ehbAppJssdk.user.getUserInfo({success:function(res){}})返回值說明:返回值說明:參數(shù)類型說明agentMobileString聯(lián)系人電話（法人）agentNameString聯(lián)系人姓名（法人）nameString企業(yè)名稱（法人）agentPhoneString企業(yè)電話（法人）entPropertyString企業(yè)類型（法人）entUnitCodeString統(tǒng)一信用代碼（法人）idCardString身份證號碼nameString姓名tokenString令牌userCertLevelString用戶等級userIdString用戶IduserImgString用戶頭像userTypeString用戶類型，1：自然人，2：法人mobilePhoneString用戶手機號ehbAppJssdk.user.login()ehbAppJssdk.user.login()ehbAppJssdk.user.logout()ehbAppJssdk.user.logout()cssjshtml接入方自測完成后，鄂匯會對應用進行審核，具體要求見第8章。通過審核后允許發(fā)布。通過灰度發(fā)布后，應用正式上線。應用正式上線運行后，接入方應保障應用的運維工作。241024服務維護申請如下。接入方修復服務問題或維護升級后需申請再次上線，通過審核并完成灰度發(fā)布后可重新上線服務。。表3應用缺陷等級對照表等級缺陷數(shù)量一般小于等于3嚴重大于3小于等于5致命大于5（）（（。DB42/T1728.2-2021UI結果信息完整性要求如下：UI輸入異常提示、結果提示、輸入方式、結果展示等應是清晰易理解的：XX）；（）6服務提供的相關結果數(shù)據(jù)準確，應與實際業(yè)務場景匹配，并保持與接入方數(shù)據(jù)一致。每對應用進行1000次訪問調(diào)用，服務故障率低于0.1%，響應異常次數(shù)不超過1次。應用的用戶界面應適配市面主流手機型號及移動操作系統(tǒng)，包括但不限于：OPPOVIVO、iPhoneHarmonyOS2.0Android5.0iOS9.0c)armnyO0x8020x18180x10ndri32x4880x00720128、1242x22081125x2436828x17921242x2688；d)網(wǎng)絡制式適配：電信、移動、聯(lián)通，網(wǎng)絡模式（5G、4G、Wi-Fi）。應用應滿足本文件4.9、4.10中的提出的性能和可用性要求。《湖北政務服務接口注冊申請表》（見表A.1）、《湖北政務服務應用接入申請表》（見表A.2）、《湖北政務服務應用接入清單》（見表D.1）、《湖北政務服務應用接入聯(lián)調(diào)測試審核報告》全部提交并審核通過，其中《湖北政務服務應用接入聯(lián)調(diào)測試審核報告》格式應符合附錄D.2的規(guī)定。應用身份鑒別技術要求包括但不限于：應用訪問控制技術要求包括但不限于：（）（）；應用審計日志技術要求包括但不限于：6應用數(shù)據(jù)安全技術要求包括但不限于：應用代碼安全技術要求包括但不限于：應用通信安全性要求包括但不限于：應用涉及的付費項目應有明確的文字說明付費用途，且付費前應得到用戶確認。未經(jīng)用戶授權，應用不應接受遠程控制指令或進行相關操作，不得嘗試獲取終端遠程訪問權限。應用防范惡意傳播包括但不限于：應用未經(jīng)授權，不應具有包括但不限于以下的惡意行為：）；IP附錄A（規(guī)范性）接入申請表A.1湖北政務服務接口注冊申請表湖北政務服務接口注冊申請表見表A.1。表A.1湖北政務服務接口注冊申請表接口對應便民服務名稱是否需要提交政務外網(wǎng)訪問策略□是□否IP歸屬IP接口地址接口承載能力返回格式請求方式接口協(xié)議接口備注請求參數(shù)參數(shù)名必填（是|否）類型（string|integer）參數(shù)示例參數(shù)說明參數(shù)位置（body,headers,query,path）返回參數(shù)參數(shù)名必填（是|否）類型說明（結果狀態(tài)碼）返回示例A.2湖北政務服務應用接入申請表A.2湖北政務服務應用接入申請表湖北政務服務應用接入申請見表A.2。表A.2湖北政務服務應用接入申請表接入單位名稱接入單位責任部室接入單位負責人聯(lián)系電話接入單位聯(lián)系人聯(lián)系電話電子郵箱開發(fā)負責人聯(lián)系電話白名單訪問IP服務名稱服務對象應用展現(xiàn)渠道服務主體（所屬廳局）服務簡介是否需要用戶登錄是否需要認證（認證等級）個人□法人□PCAPP是□否身份證實名認證□銀行卡認證人臉識別個人法人□PC□APP是否身份證實名認證□銀行卡認證人臉識別個人法人□PC□APP是否身份證實名認證□銀行卡認證人臉識別個人法人□PC□APP是否身份證實名認證□銀行卡認證人臉識別以上表格可自行添加B.2通用接口返回參數(shù)表B.2提供了通用返回參數(shù)定義，需接入方實現(xiàn)。B.2通用接口返回參數(shù)表B.2提供了通用返回參數(shù)定義，需接入方實現(xiàn)。表B.2通用接口返回參數(shù)表B.3區(qū)劃代碼表附錄B（規(guī)范性）鄂匯辦開放平臺接口說明B.1鄂匯辦開放平臺接口說明表B.1提供了通用接口參數(shù)定義，接入方根據(jù)實際需要選擇實現(xiàn)。表B.1通用接口請求參數(shù)參數(shù)名稱是否必須數(shù)據(jù)類型描述參數(shù)值示例_cityCode否，僅當機構業(yè)務需要按城市區(qū)分String省、市、縣國標碼省級：420000—湖北省地市級：420100縣級：421122—紅安縣_sign否，僅當需要通過簽名方式鑒權String簽名字符串-_signType否，僅當需要通過簽名方式鑒權String生成簽名字符串所使用的簽名算法類型SM2、HMAC-SHA256_charset否，不傳則用機構當前默認字符集String編碼字符集，默認為utf-8utf-8gb2312gbkgb18030_timestap否，僅當對高安全級別接口需要控制請求過期時間String請求發(fā)起時間，格式：2015-04-2615:23:12參數(shù)名數(shù)據(jù)類型描述參數(shù)值示例rtnCodeString返回狀態(tài)碼，由接入方提供返回狀態(tài)碼000000—處理成功400000—處理失敗103000—處理中rtnMessageString返回消息,由接入方提供返回消息-dataString返回數(shù)據(jù)，由接入方提供返回數(shù)據(jù)-signString返回內(nèi)容簽名值，僅當高安全級別接口需要接收方驗證內(nèi)容一致性時返回-區(qū)劃代碼見表B.3。表B.3區(qū)劃代碼表區(qū)劃編碼級別區(qū)劃名稱420000省級湖北省420100市級武漢市420200市級黃石市420300市級十堰市420500市級宜昌市420600市級襄陽市420700市級鄂州市420800市級荊門市420900市級孝感市421000市級荊州市421100市級黃岡市421200市級咸寧市421300市級隨州市422800市級恩施州429004市級仙桃市429005市級潛江市429006市級天門市429021市級神農(nóng)架林區(qū)420102縣級江岸區(qū)420103縣級江漢區(qū)420104縣級硚口區(qū)420105縣級漢陽區(qū)420106縣級武昌區(qū)420107縣級青山區(qū)420111縣級洪山區(qū)420112縣級東西湖區(qū)420113縣級武漢開發(fā)區(qū)（漢南區(qū)）420114縣級蔡甸區(qū)420115縣級江夏區(qū)420116縣級黃陂區(qū)420117縣級新洲區(qū)420118縣級東湖新技術開發(fā)區(qū)420150縣級東湖生態(tài)旅游風景區(qū)420202縣級黃石港區(qū)420203縣級西塞山區(qū)420204縣級下陸區(qū)420205縣級開發(fā)區(qū)鐵山區(qū)表B.3區(qū)劃代碼表（續(xù)）區(qū)劃編碼級別區(qū)劃名稱420222縣級陽新縣420281縣級大冶市420302縣級茅箭區(qū)420303縣級張灣區(qū)420304縣級鄖陽區(qū)420322縣級鄖西縣420323縣級竹山縣420324縣級竹溪縣420325縣級房縣420350縣級十堰經(jīng)濟技術開發(fā)區(qū)420351縣級武當山旅游經(jīng)濟特區(qū)420381縣級丹江口市420502縣級西陵區(qū)420503縣級伍家崗區(qū)420504縣級點軍區(qū)420505縣級猇亭區(qū)420506縣級夷陵區(qū)420525縣級遠安縣420526縣級興山縣420527縣級秭歸縣420528縣級長陽土家族自治縣420529縣級五峰土家族自治縣420550縣級宜昌高新區(qū)420581縣級宜都市420582縣級當陽市420583縣級枝江市420602縣級襄城區(qū)420606縣級樊城區(qū)420607縣級襄州區(qū)420624縣級南漳縣420625縣級谷城縣420626縣級?？悼h420650縣級襄陽高新技術開發(fā)區(qū)420682縣級老河口市420683縣級棗陽市420684縣級宜城市420702縣級梁子湖區(qū)420703縣級華容區(qū)420704縣級鄂城區(qū)表B.3區(qū)劃代碼表（續(xù)）區(qū)劃編碼級別區(qū)劃名稱420750縣級葛店經(jīng)濟技術開發(fā)區(qū)420802縣級東寶區(qū)420804縣級掇刀區(qū)420822縣級沙洋縣420850縣級荊門市漳河新區(qū)420851縣級荊門市屈家?guī)X管理區(qū)420881縣級鐘祥市420882縣級京山市420902縣級孝南區(qū)420921縣級孝昌縣420922縣級大悟縣420923縣級云夢縣420950縣級孝感高新技術開發(fā)區(qū)420951縣級孝感市雙峰山度假區(qū)420952縣級孝感市臨空經(jīng)濟區(qū)420981縣級應城市420982縣級安陸市420984縣級漢川市421002縣級沙市區(qū)421003縣級荊州區(qū)421022縣級公安縣421023縣級監(jiān)利縣421024縣級江陵縣421050縣級荊州經(jīng)濟技術開發(fā)區(qū)421081縣級石首市421083縣級洪湖市421087縣級松滋市421102縣級黃州區(qū)421121縣級團風縣421122縣級紅安縣421123縣級羅田縣421124縣級英山縣421125縣級浠水縣421126縣級蘄春縣421127縣級黃梅縣421171縣級龍感湖示范區(qū)421172縣級黃岡高新區(qū)421173縣級白蓮河示范區(qū)421181縣級麻城市表B.3區(qū)劃代碼表（續(xù)）區(qū)劃編碼級別區(qū)劃名稱421182縣級武穴市421202縣級咸安區(qū)421221縣級嘉魚縣421222縣級通城縣421223縣級崇陽縣421224縣級通山縣421250縣級咸寧國家高新開發(fā)區(qū)421281縣級赤壁市421303縣級曾都區(qū)421321縣級隨縣421350縣級隨州高新區(qū)421351縣級大洪山風景名勝區(qū)421381縣級廣水市422801縣級恩施市422802縣級利川市422822縣級建始縣422823縣級巴東縣422825縣級宣恩縣422826縣級咸豐縣422827縣級來鳳縣422828縣級鶴峰縣B.4返回狀態(tài)碼表B.4返回狀態(tài)碼表返回狀態(tài)碼見表B.4。表B.4返回狀態(tài)代碼表類型狀態(tài)碼英文描述中文描述信息1001001Continue繼續(xù)1011001SwitchingProtocols交換協(xié)議成功2001001OK成功2011001Created創(chuàng)建2021001Accepted已接受2031001Non-AuthoritativeInformation非權威信息2041001NoContent沒有內(nèi)容2051001ResetContent重置內(nèi)容2041001NoContent沒有內(nèi)容2051001ResetContent重置內(nèi)容2061001PartialContent部分內(nèi)容表B.4返回狀態(tài)代碼表（續(xù)）類型狀態(tài)碼英文描述中文描述重定向3001001MultipleChoices多種選擇3011001MovedPermanently資源永久移動3021001Found找到資源3031001SeeOther參見其他3041001NotModified未修改3051001UseProxy使用代理3061001Unused未使用3071001TemporaryRedirect暫時重定向客戶端錯誤4001001BadRequest錯誤的請求4011001Unauthorized未經(jīng)授權4021001PaymentRequired付費請求4031001Forbidden禁止4041001NotFound沒有找到資源，無響應4051001MethodNotAllowed方法不允許4061001NotAcceptable不可接受4071001ProxyAuthenticationRequired需要代理身份驗證4081001RequestTimeout請求超時4091001Conflict指令沖突4101001Gone文檔永久地離開了指定的位置4111001LengthRequired需要Content-Length頭請求4121001PreconditionFailed前提條件失敗4131001RequestEntityTooLarge請求實體太大4141001Request-URITooLong請求URI太長4151001UnsupportedMediaType不支持的媒體類型4161001RequestedRangeNotSatisfiable請求的范圍不可滿足4171001ExpectationFailed期望失敗服務器錯誤5001001InternalServerError內(nèi)部服務器錯誤5011001NotImplemented未實現(xiàn)5021001BadGateway錯誤的網(wǎng)關5031001ServiceUnavailable服務不可用5041001GatewayTimeout網(wǎng)關超時5051001HTTPVersionNotSupportedHTTP版本不支持B.5接口注冊示例B.5接口注冊示例接入方應將開發(fā)應用所需接口注冊至鄂匯辦開放平臺，注冊參數(shù)見表D.5，包括接口地址、請求方式，以及相關請求參數(shù)與返回結果示例。表B.5接口注冊示例表接口對應便民服務名稱職工帳戶信息查詢--**市公積金信息查詢是否需要提交政務外網(wǎng)訪問策略□是□否IP歸屬（無需訪問政務外網(wǎng)可不填）IP（無需訪問政務外網(wǎng)可不填）接口地址http://***/***/query接口承載能力1000并發(fā)下100tps返回格式Json請求方式post接口協(xié)議http接口備注職工帳戶信息查詢接口對應**市公積金信息查詢服務請求參數(shù){"idCard":"4201**************"}參數(shù)名必填（是|否）類型（string|integer）參數(shù)示例參數(shù)說明參數(shù)位置（body,headers,query,path）idCard是string4201**********身份證號碼body返回參數(shù)參數(shù)名必填（是|否）類型說明（結果狀態(tài)碼）name是string查詢?nèi)诵彰鹴ime是string業(yè)務時間code是string成功響應編碼message是string響應消息返回示例{"code":"0000","name":"***","time":"2019-01-01","message":"業(yè)務正常處理完畢。"}B.6接口調(diào)用示例B.6接口調(diào)用示例調(diào)用接口示例見表B.6。表B.6接口調(diào)用示例方法說明農(nóng)機信息查詢接口請求方法PostURL地址http://{API_ROOT}/hbzwAppSe