DB4206T 27-2021 政务服务移动端接入技术规范

ICS35.240.01L77

DB4206襄 阳 市 地 方 标 准DB4206/T27—2021政务服务移动端接入技术规范发布襄阳市市场监督管理局发布襄阳市市场监督管理局2021030420210205DB4206/T27DB4206/T27—2021II前  言本标准依据GB/T1.1-2020《标准化工作导则第1部分：标准的结构和编写规则》编写。本标准由襄阳市政务服务和大数据管理局提出。本标准由襄阳市政务信息标准化技术委员会归口。本标准为首次发布。DB4206/T27DB4206/T27—2021DB4206/T27DB4206/T27—2021政务服务移动端接入技术规范范围本标准规定了政务服务移动端的流程、技术要求、审核要求、管理要求和运营要求等内容。本标准适用于襄阳市政务服务移动端系统建设。规范性引用文件GB/T7027信息分类和编码的基本原则与方法GB/T19488.4GB/T21062GB/T21063GB/T346781下列术语与定义适用于本规范。1下列术语与定义适用于本规范。3.1政务服务移动端系统县（市、区、开发区和部门政务服务移动应用及资源的汇聚接入系统，面向自然人、法人和其他组织提供全市政务服务移动端查询、咨询和移动办事服务的入口。3.2政务服务应用由县（市、区、开发区或部门为自然人、法人和其他组织提供各类网上政务服务。3.33 术语和定义DB11/T553政务信息资源共享交换平台技术规范DB3301/T0169智慧电子政务数据资源共享管理规范DB4206/Z5襄阳市政务信息化总体技术框架国办函〔2016〕108号国务院办公厅关于印发“互联网+政务服务”技术体系建设指南的通知201845政务数据资源（3.4数据共享3.5基础数据库3.6专业数据库2数据共享类别2数据共享类别（、受限共享类数据（只能按照特定方式或提供给指定对象共享的，需数据提供单位审核的数据、非共享类数据（依照法律、法规、规章规定不能共享，或未经脱密、脱敏处理不能共享的数据。3.9数据共享模式（、数据查询方式（通过调用查询服务接口，获取所需条件的数据结果，提供单条或多条数据包、数据交换方式（通过数据交换系统等方式，提供批量数据交换。3.10政务数据资源共享交换管理平台3.83.7政务信息资源目录管理系统通过编目、注册、发布和维护政务信息资源目录内容，实现政务信息资源管理、发现与定位的系统。移动应用接入概述总则系统总体架构3系统功能定位功能定位功能定位主要有以下几个方面：统一服务入口、提升用户体验；图1 总体构架示意图20163系统功能定位功能定位功能定位主要有以下几个方面：统一服务入口、提升用户体验；图1 总体构架示意图多地区个性化服务集约化管理；为移动政务应用建立统一对接、统一运维、统一推广；为政务大数据共享、融合、汇聚和挖掘奠定基础；打造全市政务服务移动端建设的开放生态体系。系统组成接口入驻子系统：全局监管政务服务移动端系统所有政务服务应用的原始业务接口，实时监控接口运行状况，对出现异常的接口及时预警；微门户管理子系统：对移动端的页面样式、栏目结构、发布信息进行管理和变更控制；运营数据统计子系统：通过服务点击量、业务办理量等关键数据进行实时统计。功能服务功能服务应满足以下几个方面：提供标准的接口入驻方式，输出统一域名、统一接口地址；提供标准的应用开发组件，保证应用体验在移动端获得一致的体验效果；制定标准的应用测试、应用上下架、应用运维管理流程，确保应用质量可靠；提供安全、统一的用户信息、用户认证、业务信息等敏感数据交互服务；提供统一的数据运营监控服务，打造以人为中心的服务体验。应用类型政务服务移动应用分为需身份信息类应用和完全开放类应用。需身份信息类应用，按照统一对接原则，经过用户授权，统一获取政务服务移动端系统用户信息。完全开放类应用无需调用用户信息，遵循统一接入流程对接各子系统。对接方式对接方式如下：接口对接：提供业务接口，按要求进行服务应用开发；数据对接：提供业务数据，先开发业务接口后再进行服务应用开发。认证方式要求所有政务服务应用均应统一采用政务服务移动端系统的用户认证体系。包括个人/法人用户的政务服务移动端接入流程4图图2 移动政务服务应用对接流程图数据交换县（市、区、开发区和部门数据要求经过市数据统一交换系统，统一处理跨网业务数据。接口入驻按照政务服务移动端系统统一对接原则，要求各县（市、区、开发区、各部门将政务服务应用接接口入驻流程5接入流程总览2。接口入驻流程如下：申请账号：联系政务服务移动端系统接入管理部门获取相关账号；接口注册：根据业务需求，对接口进行封装改造后注册接口入驻子系统；提交审核：将注册完成的接口提交审核，审核通过后即可获取标准地址；测试使用：对获取的地址进行测试后，使用接口进行服务开发。应用入驻按照政务服务移动端系统统一对接原则，要求各县（市、区、开发区、各部门将政务服务应用前应用入驻流程应用入驻流程如下：申请账号：联系项目部门获取相关账号；应用开发：根据技术对接标准，使用前端语言开发业务服务；应用上传：将开发好的应用压缩后上传应用开放子系统；6用户对接要求6用户对接要求3，流程如下：用户授权：需身份信息类服务通过政务服务移动端系统申请；授权验证：政务服务移动端系统对用户授权请求进行验证；加密用户信息：政务服务移动端系统对授权用户信息进行(SM4分发授权信息：将已加密的授权用户信息分发给请求方；解密用户信息：请求方使用政务服务移动端系统解密方式进行解密操作。6 政务服务移动端技术要求图3 移动政务服务应用接入基于票据获取用户信息交互图接口对接要求接口规范注册（（请求方式支持get、postwebservicestringinteger接口数据缓存接口安全鉴权通过政务服务移动端系统进行互联网交互的应用要求进行接口访问鉴权，支持两种鉴权模式：SM2，双方以安全方式存储接口鉴权密钥；（7接口功能自测（确认业务接口正常接通，确定接口返回数据格式；接口需要满足高并发的要求，并发数应达到1000+，响应时长不超过2s；接口需要满足安全性的要求，涉及敏感信息应进行加密或脱敏处理。扩展性要求支持支付宝、微信、生物特征识别等多种应用接口开发与对接。应用开发要求应用安全提交政务服务应用使用HTML5语言开发，业务接口要求调用接口入驻子系统返回的标准。接口地址和key（应用代码需封装成压缩包（.zip）提交应用开放子系统。底部统一标识政务服务移动端的所有页面底部都需注明“本服务由某某单位提供”。图形验证码使用、开发区和部门可以自行决定多少次提交表单后再显示验证码。对于图形验证码的技术要求建议如下：验证码在设计上必须要考虑到相关安全因素，常见的方式是增加背景干扰元素；验证码在一次使用后应立即失效，新的请求需要重新生成验证码，防止验证码多次有效。表单输入校验县（市、区、开发区和部门开发服务应用时必须对用户产生的输入内容进行校验，不能完全依赖SQLXSS攻击等恶意行为。应用模拟测试（要求县（市、区）、开发区和部门应用审核前，对应用进行全面测试，确保页面正常访问；8消息推送要求、开发区展示，A。安全保护要求关键信息脱敏B。身份真实性控制对于涉及用户隐私的，应仅限高级实名用户进入；如有必要，还可发起实时人脸识别身份验证。用户授权确认HTTPS为防止网络劫持、页面挂码等风险，要求政务服务移动端系统支持HTTPS访问，接入单位在开发应用服务时需保证页面加载的所有资源协议支持HTTPS访问。政务服务移动端审核要求原则页面要求为保证政务服务移动端在上架后用户体验一致，县（市、区、开发区和部门需按照要求统一页面设计，增强用户体验。具体页面要求如下：兼容性高，能够自动适配不同（主流）手机机型；交互提示友好，不同使用场景下要有对应的使用引导；结构布局清晰，相同类型业务数据要归类展示，不同业务数据展示方式要有区分；体验流畅高效，页面数据展示延时最长不超过2s，页面切换平滑流畅；操作层级简化，完整流程页面跳转最多不超过5层，精简页面流程设计。9质量要求服务风格统一。服务功能完善。服务体验流畅。所有接入的应用考虑设备兼容苹果IOS系统和安卓Android系统，避免出现空白页、错链、死链等情况。服务性能稳定。所有接入的应用接口响应快，能抗压抗并发，并准备故障解决预案。服务安全可靠。10为保障政务服务移动端系统不断接入更加优质的服务，参考国办发〔10为保障政务服务移动端系统不断接入更加优质的服务，参考国办发〔2018〕45号文件调动社会资、开发区建立相应的运维保障小组，应用上下线管理包括政务服务应用兼容做好信息可用性监控；做好服务稳定性检查；对访问数据做好监测和分析；求制定可行的故障应急预案；做好政务服务应用版本管理。8 政务服务移动端管理要求AlipayJSBridge.call('xyrequest',{AlipayJSBridge.call('xyrequest',{url:'/comment/music?id=186016&limit=1',type:'get',data:{},headers:{'Content-Type':'application/json'7. },8. },(result)=>{11使用示例返回参数：附 录 A（规范性附录）Api网络请求名称：xyrequest调用参数：参数名必选类型说明url是string如果是相对地址，默认拼接Nginx（包含头，则直接使用。type是string请求的方式，post\get，默认为post。data是jsonstring可以为空headers是string网络请求头参数名类型说明codestring010011002500msgstring成功时为“成功”，失败时返回异常原因。datajsonstring请求返回数据，正确时返回具体业务数据,失败时为空。1.12.console.log("xyrequestcode--"+result.code)console.log("xyrequestmsgresult.msg)console.log("xyrequestdata--"+result.data)});1. AlipayJSBridge.call('xyrequest',{2.url:'83:8443/imp/platform/menu/findDangMenu/990001625/a29e3206e141413ea7fcf418d1143c1e',type:'post',data:{},headers:{'Content-Type':'application/json','channel':'PC','dangsessionId':'baa2bbc0-63cf-4d71-aa53-b10f44e680c2'9. },10. },(result)=>{console.log("xyrequestcode--"+result.code)console.log("xyrequestmsgresult.msg)console.log("xyrequest掉到了data--"+result.data)14. });显示toast名称：showToast调用参数：参数名必选类型说明msg是string显示的文字信息type是string显示toast类型，success为成功，fail为失败，其余为默认形式。返回参数：无使用示例AlipayJSBridge.call('showToast',{AlipayJSBridge.call('showToast',{type:'success',msg:'你好',124. },(result)=>{4. },(result)=>{5. });显示loading名称：showLoadingDialog调用参数：参数名必选类型说明msg否string显示文字信息。默认为加载中cancelable否stringfalse/true。标示是否可以取消，包括点击屏幕取消/返回键取消。如果不可取消，需要调用隐藏AlipayJSBridge.call('showLoadingDialog',{cancelable:'true',AlipayJSBridge.call('showLoadingDialog',{cancelable:'true',msg:'你好'4. },(result)=>{5. console.log("showLoadingDialog6. });13名称：hideLoadingDialog调用参数：A.4 loading使用示例参数名类型说明loadingDialogIdstring隐藏loadingdialog需要传的参数。参数名必选类型说明参数名必选类型说明loadingDialogId是stringshowLoadingDialog返回值。不传或者错误值都无法将loadingdialog隐藏。返回参数：无。使用示例AlipayJSBridge.call('hideLoadingDialog',{AlipayJSBridge.call('hideLoadingDialog',{loadingDialogId:'',3. },(result)=>{4. });A.5 显示alertAlipayJSBridge.call('alert',{title:'亲',message:'你好',button:'确定5. },(result)=>{AlipayJSBridge.call('alert',{title:'亲',message:'你好',button:'确定5. },(result)=>{6. });AlipayJSBridge.call('confirm',{title:'亲',message:'确定要退出吗？',okButton:'是',cancelButton:'否6. },(result)=>{14mpaasAPI使用示例A.6 confirmDB4206/T27—20217.DB4206/T27—20217.});DB4206/T27DB4206/T27—2021A.7 获取网络类型名称：getNetwordType调用参数：无。返回参数：参数名类型说明netWorkStatestring标示网络类型。WIFI/2G/3G/4G/xG/NONOxGNO。1. AlipayJSBridge.call('getNetwordType',{1. AlipayJSBridge.call('getNetwordType',{2. },(result)=>{3. console.log("getNetwordType"+"######"+WorkState)4. });AlipayJSBridge.call('call',{'phoneNumber':123415返回参数：|参数名|类型|说明|无。使用示例名称：call调用参数：A.8 拨打电话参数名类型说明phoneNumberstring电话号码。无参数不执行。3. },(result)=>{3. },(result)=>{4. });A.9 获复制内容到剪切板名称：copyText调用参数：参数名类型说明textstring复制的内容。无参数不执行。返回参数：无1. AlipayJSBridge.call('copyText',{1. AlipayJSBridge.call('copyText',{2. 'text':1233. },(result)=>{4. });AlipayJSBridge.call('openBrowser',{'url':''3. },(result)=>{16返回参数：无使用示例名称：openBrowser调用参数：A.10 在浏览器中打开地址参数名类型说明urlstring复制的内容。无参数不执行。DB4206/T27DB4206/T27—2021DB4206/T27DB4206/T27—20214. });4. });A.11 导航界面名称：openMap调用参数：参数名类型说明destinationstring目的地名称。缺少参数无法调起longitudedouble目的地经度。缺少参数无法调起latitudedouble目的地纬度。缺少参数无法调起返回参数：无AlipayJSBridge.call('openMap',{'destination':'http',AlipayJSBridge.call('openMap',{'destination':'http',3. 'longitude':'116.7346286800',4. 'latitude':'39.7780677300'5. },(result)=>{6. });17A.12 打开新页面参数名类型说明urlstring必填，可以缺省http到端口部分，会自动补足nginx地址，示例：/getItemTree.htmltitlestring选填。导航栏标题closeCurrentWindowbool选填。打开窗口的同时，关闭当前window，默认falsepassDatadictonary选填。打开窗口的同时，传递参数。通过AlipayJSBridge.call(‘getStartupParams’,{},function(result){console.log(result);});获取传入的参数windowTypestring选填。传入original代表使用原生webview打开页面。使用该方案可解决MPaaS框架容器无法定位的缺陷。但是会导致所有MPaaS相关api不可用名称：open调用参数：返回参数：无使用示例AlipayJSBridge.call('open',{AlipayJSBridge.call('open',{'url':'/index.htmlhttps://,'title':'襄阳令','passData':{ab:test}5. },(result)=>{6. });1. AlipayJSBridge.call('userLogin',{1. AlipayJSBridge.call('userLogin',{2. },(result)=>{3. });名称：getXYUserInfo调用参数：18A.14 获取用户基本信息使用示例名称：userLogin调用参数：sessionuserinfouserInfogetXYUserInfoapi返回参数：参数名类型说明sgasessionstring登录sessionuserInfosgasession。反之返回法人基本信息userInfosgasession。如当前用户未登录（session),返回空返回参数：法人示例：{sgasession:’xxx’,userInfo:{activeState=0;agentAddr=“”;agentCard=“”;agentCertKey=“”;agentEmail=“”;agentFix=“”;agentMobile=“”;agentName=“”;agentPhone=“”;agentPosition=authNum=“”;authTime=“2018-11-0719:20:00”;19bz1=“”;19bz1=“”;bz10=“”;bz11=“”;bz12=“”;bz13=“”;bz2=“”;bz3=1;bz4=bz5=“”;bz6=“”;bz7=“”;bz8=“”;bz9=“”;certKey=“”;corpStatus=“”;createTime=1541589600000;cropKey=“”;cryptogram=“”;customerType=2;dn=“”;entAddress=“”;entAuthTime=“”;entCertLevel=2;entEmail=“”;entFix=“”;entLevel=2;entName=“\U8944\U9633\U6d4b\U8bd5\U4f01\U4e1a\U4e00”;entNature=“”;entPhone=“”;entProperty=“”;entScope=“”;entType=1;entTypeStr=Enterprise;entUnitCode=123456123456123456;entUrl=“”;entZipCode=“”;gjEnttype=“”;id=d81d0a8087460ac83dd795ef3ab7a384;industry=“”;legalCardlegalCertnoBeginFate=“”;legalCertnoEndFate=“”;legalMobile=“”;legalMobileKey=“”;legalCertnoBeginFate=“”;legalCertnoEndFate=“”;legalMobile=“”;legalMobileKey=“”;legalName=“\U5218\U6c49\U751f”;legalNation=“”;legalSex=“”;licenseNumber=“”;localArea=“”;mobilePhonemobilePhoneShow=“”;paidCapital=“<null>“;password=“”;range=“”;regAddress=“”;regAuthority=“”;regCapital=“<null>“;regTime=“2018-11-0719:20:00”;success=true;type=ent;userName=123456123456123456;}个人示例：20{sgasession:’xxx’,userInfo:{activeState=0;age=30;answer=“”;attribution=hbportal;authNum=“”;bz1=“”;bz10=“”;bz11=“”;bz12=“”;bz13=“”;bz2=“”;bz3=“”;bz4=“”;bz5=“”;bz6=“”;bz7=“”;bz8=“”;21carColor=“”;carInsurance=“”;carModel=“”;carNumber=“”;cardAuthTime=“”;certEffDate=“”;certExpDate=“”;certKey=“”;certType=“”;chassisNumber=“”;createTime=1585647586000;createUser=“”;cryptogram=“”;customerType=1;21carColor=“”;carInsurance=“”;carModel=“”;carNumber=“”;cardAuthTime=“”;certEffDate=“”;certExpDate=“”;certKey=“”;certType=“”;chassisNumber=“”;createTime=1585647586000;createUser=“”;cryptogram=“”;customerType=1;defaultPwd=1;driverLicense=education=“”;email=“”;engineNumber=“”;facePic=“”;froms=1;graduationTime=“”;highAuthTime=“”;homeAddress=“”;id=c0ecd7e9293f57e9adadc2cacd454db6;idCardjob=“”;localArea=4206;locked=“”;maritalStatus=mobilePhonemobilePhoneShow=“”;name=“\U5f20\U4e09”;nation=“”;officePhone=“”;officerLicense=“”;passport=“”;password=“”;permitLicense=“”;posCode=“”;questionCode=“”;questionName=“”;1. AlipayJSBridge.call('getXYUserInfo',{1. AlipayJSBridge.call('getXYUserInfo',{2. },(result)=>{3. });A.15 获取定位信息22sex=2;socialSecurityNum=“”;success=true;type=person;university=“”;userCertLevel=2;userLevel=“1,2-2“;userMobile=“”;userNameuserRealLvl=“”;userRegion=“”;userSsiLocation=“”;userType=1;}}使用示例名称：getSgaLocation调用参数：无参数返回参数：“errorCode”0,//错误码为零默认无问题“latitude”//纬度23名称：faceRecoginition23名称：faceRecoginition调用参数：无参数返回参数：A.16 人脸识别认证使用示例.AlipayJSBridge.call('getSgaLocation',{},(result)=>{});参数名类型说明codeinteger错误码为零为认证成功errorstring参数名类型说明直接在人脸识别调用完毕后在当前页面弹窗提示用户错误信息。H5api息当前登录用户无认证等级数据userInfodictionaryidentLevel4userInfo使用示例.4.AlipayJSBridge.call('faceRecoginition',{},(result)=>{});A.17 获取请求headers名称：getAppInfo24A.18 获取应用基本信息名称：getAppInfo24A.18 获取应用基本信息使用示例无参数返回参数：.AlipayJSBridge.call('getSgaHeaders',{},(result)=>{});参数名类型说明macstring设备唯一标识码sgasessionstring登录状态下返回有效session，反之返回空字符串tokenstring加密认证token调用参数：无参数返回参数：参数名类型说明appIdstring应用唯一标识码，如com.xiangyanggov.sgaversionstring应用当前版本号，如1.0buildstring应用当前build号，如36appNamestring应用中文名称，襄汇办AlipayJSBridge.call('updateUserInfo',{'userInfo':{'name':'litong','level':'1}AlipayJSBridge.call('updateUserInfo',{'userInfo':{'name':'litong','level':'1}3. },(result)=>{25返回参数：无参数名称：updateUserInfo调用参数：A.19 更新客户端的UserInfo.AlipayJSBridge.call('getAppInfo',{},(result)=>{})参数名类型说明userInfodictionary需要更新的部分userInfo字段，如userInfo:{‘name’:’litong’,’level’:’1}。不需要更新的字段不用放4. })4. })A.20 更新客户端的密码名称：updatePassword调用参数：参数名类型说明userNamestring\faceID机认证登录时，更新相应用户的密码passWordstring密码返回参数：无参数AlipayJSBridge.call('updatePassword',{'userName':'xxx",AlipayJSBridge.call('updatePassword',{'userName':'xxx",'passWord':'xxx'4. },(result)=>{5. })26调用参数：返回参数：名称：multiFaceRecoginitionA.21 自定义人脸识别认证参数名类型说明realNamestring用户名，必填idCardNumstring用户身份证号，必填参数名类型说明参数名类型说明codeintegercode为0代表认证成功，为1是认证失败errorstring错误信息，返回错误信息但原生不弹窗提示认证结果使用示例AlipayJSBridge.call('multiFaceRecoginition',{AlipayJSBridge.call('multiFaceRecoginition',{'realName':'李桐",'idCardNum':'xxx'4. },(result)=>{5. });A.22 获取扫描二维码值1. AlipayJSBridge.call('getQRMsg',{2. },(result)=>{3. });1. AlipayJSBridge.call('getQRMsg',{2. },(result)=>{3. });27名称：downloadImmovablesPic调用参数：A.23 不动产保存图片到相册使用示例返回参数：参数名类型说明参数名类型说明qrMsgstring二维码包含的字符串值参数名必选类型说明参数名必选类型说明zzh是int请求体参数返回参数：参数名类型说明respCodestring0respMsgstring成功时为“成功”，失败时返回异常原因。使用示例.4.5.AlipayJSBridge.call('downloadImmovablesPic',{zzh:11111111,},(result)=>{});28使用示例28使用示例返回参数：名称：xySavePic调用参数：.5.AlipayJSBridge.call('xySavePic',{base64:"111111",},(result)=>{});参数名必选类型说明base64是string请求体参数,图片的base64参数名类型说明respCodestring0为保存成功，1001为网络请求出错，1002为移动端数据解析出错。respMsgstring成功时为“成功”，失败时返回异常原因。地点选择名称：setXYLocation返回参数：参数名类型说明nameCityString城市中文名，默认为定位城市codeCitystring城市编号默认为空，如果城市匹配上，返回对应的城市编码使用示例1. 1. AlipayJSBridge.call('setXYLocation',{2. },(result)=>{3. });AlipayJSBridge.call('xyGFRequest',{url:'/comment/music?id=186016&limit=1',AlipayJSBridge.call('xyGFRequest',{url:'/comment/music?id=186016&limit=1',type:'get',29使用示例返回参数：参数名必选类型说明url是stringNginxhttp头，则直接使用。type是string请求的方式，post\get，默认为post。data是jsonstring可以为空headers是string网络请求头参数名类型说明respCodestring0为成功，1001为网络请求出错，1002为移动端数据解析出错。respMsgstring成功时为“成功”，失败时返回异常原因。respDatajsonstring请求返回数据，正确时返回具体业务数据,失败时为空。data:{},data:{},headers:{'Content-Type':'application/json'7. },8. },(result)=>{console.log("--"+result.code)console.log("--"+result.msg)console.log("--"+result.data)12. });跳转第三方应用api30A.28 文件上传api使用示例30A.28 文件上传api使用示例返回参数：.//androidqqAlipayJSBridge.call('openThirdApp',{urlScheme:'mqqapi://card/show_pslcard?src_type=internal&version=1&uin=506547525',5. appPkg:'com.tencent.mobileqq'6. },(result)=>{7. });参数名必选类型说明urlScheme是string跳转的urlScheme地址appPkg是string第三方应用的标示码参数名类型说明isOpenstring0，1apppkg，2请联系原生开发人员排查问题。errorstringisopen为2时返回异常原因。名称：xyUploadFile调用参数：参数名必选类型说明url是stringNginx（头，则直接使用。data否jsonobject请求体，除去文件流的剩下请求体，默认为空headers否jsonobject除去Conte