DB52T 1261-2018 政务云 贵州省电子政务网 应用平台接入规范

DB52DB52/T1261—2018政务云贵州省电子政务网应用平台接入规范贵州省质量技术监督局发布I 1 1 2 2 4 6 8 1政务云贵州省电子政务网应用平台接入规范本标准规定了贵州省电子政务网应用平台接入的基本要求、接入要求、运维管理要求。本标准适用于需要接入贵州省电子政务网应用平台的业务应用系统。2术语和定义下列术语和定义适用于本文件。贵州省电子政务网贵州省电子政务网是由贵州省人民政府办公厅牵头统一建设的，面向全省各级政府及其部门，集协同工作、学习，加强内部管理、交流等功能为一体的全省政府系统行政办公总平台及总入口，是贵州省电子政务云的一个重要应用平台，其基于国家电子政务外网环境建设，功能定位主要是为全省政府系统公务人员提供信息资源共享、数据互联互通和联动办公服务。政务服务开放平台贵州省电子政务网应用平台中专用于为本标准规范所定义的业务应用系统及服务进行管理的一个子系统。主要用于对需要接入贵州省电子政务网应用平台的业务应用系统、服务、服务提供方、服务使用方等各种要素信息进行流程化的管理维护。业务应用系统贵州省电子政务网应用平台中接入的各种解决政务业务需求的软件系统。包括贵州省电子政务网应用平台中已有的基础办公系统、接入的其它第三方厂商软件系统等，但不包括平台底层支撑组件。服务接入的业务应用系统中的某些功能利用技术接口的方式单独提供出来供其它业务应用系统调用的形式称为服务，例如发送工作文件服务、查询机构信息服务、监听接收和发送公文服务等等。2DB52/T1261—20182.5服务提供方提供完整业务应用系统或服务，并将业务应用系统及服务在政务服务开放平台中注册并发布的组织或机构。2.6服务使用方需要调用政务服务开放平台上发布的服务或业务应用系统的组织或机构。2.7平台运营方对贵州省电子政务网应用平台进行运维和管理服务的组织或机构。2.8业主单位在政务服务开放平台中注册的业务应用系统的直接责任单位。3基本要求3.1业务应用系统及服务应按4.4条进行注册。3.2业务应用系统应以贵州省电子政务网应用平台中的统一组织机构人员数据库作为基础数据实现机构人员数据共享。3.3业务应用系统应以贵州省电子政务网应用平台中的统一认证系统作为身份认证单点登录的入口。3.4业务应用系统应按本标准中相应技术接口服务规范向贵州省电子政务网应用平台推送操作日志、提醒消息、待办事项等与工作相关的人员行为数据信息。3.5服务提供方及业主单位应规范运维和管理接入的业务应用系统和服务，确保正常运行，不得影响到贵州省电子政务网应用平台的正常运转。4接入要求4.1接入网络要求贵州省电子政务网应用平台运行于国家电子政务外网，业务应用系统接入贵州省电子政务网应用平台应通过国家电子政务外网环境进行接入。4.2接入技术要求4.2.1服务提供方在提供服务技术接口时，应遵行以下接口要求：a)服务接口要求支持XML和JSON数据格式。XML遵行XML1.0第5版规范，JSON遵行RFC4627规范；并要求支持JAVA、PHP、Javascript、.NET等主流开发语言；b)服务接口要求支持SDK或API模式，并支持WebService或Restful两种接口方式，同时提供详细接口技术文档。34.2.2业务应用系统应兼容支持HTML5标准规范的现代浏览器，移动端应支持Android4.流程4DB52/T1261—20184.4.2服务提供方注册流程服务提供方完整填写《业务系统注册基本信息表》（见附录A.1相关人员单位签字用章后，提交给政务服务开放平台管理人员。政务服务开放平台管理人员负责审批服务提供方提交业务系统注册基本信息，审批通过后配发业务应用系统负责人的登录账号密码给服务提供方的业务应用系统负责人。业务应用系统负责人通过账号密码登录到政务服务开放平台进行后续操作。4.4.3服务提供方申请发布服务流程业务应用系统注册基本信息审批通过后，服务提供方才可以进行申请发布服务的流程。服务提供方完整填写《服务发布申请基本信息表》（见附录A.2相关人员单位签字用章后，提交给政务服务开放平台管理人员，审批通过后可在政务服务开放平台中发布该服务。要发布的服务的每一个服务接口都需要单独填写一份《服务接口内容信息表》（见附录A.3提交给政务服务开放平台管理人员。4.4.4服务使用方申请使用业务应用系统或服务流程申请业务应用系统使用时，完整填写《业务应用系统使用申请基本信息表》（见附录A.5）,提交给政务服务开放平台管理人员，审批通过后将由业务应用系统的服务提供方与申请单位联系后续开通使用事宜。申请使用服务时，完整填写《服务使用申请基本信息表》（见附录A.4提交给政务服务开放平台管理人员，审批通过后申请方按相关技术规范使用，使用过程中的技术问题由该服务的服务提供方提供支持。4.5接入技术规范4.5.1业务应用系统在调用服务接口时，应先进行身份鉴权，接口鉴权规范见附录B。4.5.2贵州省电子政务网平台已提供的“基础通用服务”类别的接口描述与技术规范见附录C。4.5.3贵州省电子政务网平台已提供的“政务业务事项服务”类别的接口描述与技术规范见附录D。4.5.4接口返回代码规范与对照表见附录E。4.5.5服务提供方在发布其它服务时的设计规范见附录F。5运维管理要求5.1业主单位管理要求5.1.1业主单位负责本单位所选取的业务应用系统的服务提供方的资质与能力审核，并为该业务应用系统或服务接入贵州省电子政务网应用平台进行审批并承担相应管理责任。5.1.2业主单位负责协调所选取的业务应用系统的服务提供方与平台运营方的对接工作。5.1.3业主单位应为本单位接入的业务应用系统制定相应的运维策略与安全策略，并确保正常执行。5.2服务提供方管理要求5.2.1服务提供方应为业务应用系统指定负责人，负责与平台运营方进行对接，并承担管理责任。5.2.2服务提供方应按规范提供业务应用系统或服务，并保障其正常稳定的运行于贵州省电子政务网应用平台之上。5.2.3服务提供方负责提供接入的业务应用系统及服务的技术支持和运维服务。55.2.4服务提供方应为接入的每一个业务应用系统或服务均提供测试报告，配合平台运营方的要求做联合调试工作，并确保其稳定性。5.2.5负责自己管理的业务应用系统或服务的缺陷修正及更新发布等工作。5.3服务使用方管理要求5.3.1按照贵州省电子政务网开放平台相关要求规范使用业务应用系统及服务。5.3.2在使用服务过程中如发现缺陷或需要改进的地方，应主动与平台运营方进行沟通。5.4平台运营方管理要求5.4.1负责贵州省电子政务网应用平台业务应用系统及服务接入的日常管理与技术支持。5.4.2负责平台基础通用服务和政务业务事项服务技术接口的维护更新与缺陷修正。5.5应急处置5.5.1业务应用系统或服务发生严重故障时，如影响到贵州省电子政务网应用平台或其它业务应用系统的正常运行时，平台运营方有权要求暂停该系统和服务，直到整改正常方可申请恢复。6DB52/T1261—2018（规范性附录）接入管理流程相关信息表A.1业务系统注册基本信息表表A.1业务系统注册基本信息表A.2服务使用申请基本信息表表A.2服务使用申请基本信息表7厂商名称：厂商系统标识：已接入业务系统：业务系统负责人：联系电话：联系邮箱：申请发布的服务类别和名称：申请提供原因：服务厂商负责人签名：业主单位联系人签名：服务厂商用章：业主单位用章：服务接口名称：服务接口URL:所属业务系统：数据标准说明：在线测试结果：申请单位名称：联系人：8DB52/T1261—2018（规范性附录）接口鉴权规范B.1接口签名使用规范B.1.1待签名的字符串在请求参数列表中，除去sign签名和token令牌参数外，其他需要使用到的参数都是需要签名的参数，相关要求如下：a)对于参数排序要求是按a到z的顺序排序；b)参数统一使用小写字母方式；c)若参数存在多层结构，只取第一层进行签名；d)若参数没有值，无需包含到签名数据列表中；e)根据HTTP协议要求,传递参数的值中如果存在特殊字符(如:&、@等),那么该值需要做URLEncoding；f)待签名数据应该是原生值而不是encoding之后的值。注：调用某接口需要对请求参数email进行数字签名,那么待签名数据应该是email=test@,而不是B.1.2待签名字符串案例待签名字符串格式采用URI中QUERY参数串的方式进行组合，示例如下。“service=create_direct_pay_by_user”,“partner=2088101568338364”,“return_url=/alipay/return_url.asp”,“subject=订单业务”,“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进行签名B.1.3.1在签名时,需要私钥参与签名。私钥是以事先分配给不同接入账号的英文字母和数字组成的32位字符串。B.1.3.2当拿到请求时的待签名字符串后,需要把私钥直接拼接到待签名字符串的后面,形成新的字符串,利用SM3加密函数对这个新的字符串进行签名运算,从而得到签名结果字符串(该字符串赋值于参数sign)，并将签名结果字符串全部字母转换为小写字母。9B.2令牌使用规范使用基于Token的身份验证方法，大概的流程是这样的：a)客户端使用用户名跟密码请求登录；b)服务端收到请求，去验证用户名与密码；串)签发一个Token,再把这个Token发送给客户端；d)客户端收到Token以后可以把它存储起来，比如放在Cookie里；e)客户端每次向服务端请求资源的时候需要带着服务端签发的Token,服务端收到请求，然后去验证客户端请求里面带着的Token,如果验证成功，就向客户端返回请求的数据。B.3IP鉴权机制厂商在政务开放平台注册成功后，在调用接口前，都需要提供来访的应用IP地址，用于在服务调用前进行IP鉴权，鉴权成功后，服务接口才会响应请求，对于使用负载均衡或无法提供固定应用IP的应用，可以提交申请，告知开放平台对特定应用取消IP鉴权。B.4登录安全规范B.4.1登录认证时所需要的参数说明见表B.1。说明字符串字符串字符串返回登录信息字符串，多个字段以“,”分割。所有字段名全部小写字符串字符串排除过滤路径的资源，主要用于不需要进行认证就可以资源的访问，支持目录和指定后缀的模糊配置字符串系统推出后的通知接收URL,后台认证的多个系统中的任一系统推出后，系统会往成功登陆的其它系统发送消息，以实现单点退出功能。字符串(16位)个系统分配唯一一个Key,为了安全不能外传。字符串DB52/T1261—2018B.4.2参数加密说明登录会对关键参数采用SM4加密，先加密得到二进制串，然后将二进制传转换为16进制字符串进行传递，传递到服务端后系统根据系统ID获取对应秘钥，然后进行解密后再进行认证登录，加密的字段包括：systemid，loginOutUrl，backUrl，returnFields，uid，pwd。B.4.3参数签名参见本标准附录B.1接口签名使用规范，签名字符串用的是加密后的字符串。以Java语言举例如下。示例：remoteLogin(Stringsys参数说明见表B.2。表B.2参数表表C.1参数表参数名参数类型必须说明是请求参数签名是是是否应用系统ID,可为空，如果为空则取视图表设置的业务系统数据，如果视图是主要是用取单位从这个时间起到当前为止，有变动的数据是主要是用取部门从这个时间起到当前为止，有变动的数据是主要是用取人员从这个时间起到当前为止，有变动的数据是主要是用取身份从这个时间起到当前为止，有变动的数据是获取数据类型，0取所有更新数据1只取单位更新数据2只取部门更新数据3只取人员更新数据4只取人员身份更新数据否否是用户ID,主要用记录是哪个用户发过来的请是DB52/T1261—2018C.1.1.4响应数据解析说明返回数据为XML格式，需要自行解析使用。<?xmlversion="1.0"encodin<returncode="0">获取数<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为获取单位数据总记录数，loopcou将要循环向平台取单位实际数据的次数，lastdatetime是指单位数据更新最后时间，返回给客户端供下次调C.1.2服务动作C.1.2.1人员批量同步C.服务描述提供给第三方开发商，用于批量获取人员数据，批量获取的数据支持分页获取，每页返回最大行数不能超过100条，系统会默认返回页码数，记录总行数、以及相关页的数据明细。C.服务地址请求方式：GET,请求地址：/api/gov/org/getUserData?sign=&token=。C.请求参数说明参数名必须说明是请求参数签名是是的认证用户名。不能为空。是分配的用户密码，密码传递SM3加密后的字符串否查询数据页码，不传默认获取第一页的数据否DB52/T1261—2018C.返回数据返回数据是一个XML格式的字符串，需要自行解析，示例格式如下。<?xmlversion="1.0"encodin<recordcount>记录总数</<pagecount>总页数</pagecount><pagesize>每页记录数</pagesize><orgsystemtype=“1”orgid=””数据类型用户KEYID人员姓名人员编号身份证号登录账号登录别名手机1手机2国产密码SM33性别出生日期民族ID3是否为单位管理员1应用系统ID串人员类型学历是否政协委员333是否本单位领导3启用标记创建时间最后修改时间DB52/T1261—2018C.1.3机构批量同步C.1.3.1服务描述提供给第三方开发商，用于批量获取机构数据，批量获取的数据支持分页获取，每页返回最大行数不能超过2000条，系统会默认返回页码数，记录总行数、以及相关页的数据明细。C.1.3.2服务地址请求方式：GET，请求地址：/api/gov/org/getOrgData?sign=&token=。C.1.3.3请求参数说明表C.3参数表是是是认证用户名，每个业务系统接入都会分配一个独是否否<?xmlversion="1.0"encoding="UTF-8"<recordcount>记录总数</recordcount><pagecount>总页数</pagecount><pagesize>每页记录数</pagesize><systemtype>所属体系1,政府2,人大，3政协，4党委</systemtype>DB52/T1261—201836363C.1.4机构人员选择C.1.4.1服务描述提供给第三方开发商，选择人员和机构的界面，首先要通过系统验证，系统会先生成随机码，随机码只能使用一次，使用后自动作废。C.1.4.2服务地址请求方式：GET,请求地址：/api/gov/org/getSelectUser?sigC.1.4.3请求参数说明表C.4参数表参数名参数类型必须说明是请求参数签名是是独立的认证用户名。不能为空。是分配的用户密码，密码传递SM3加密后的字符串否1、返回机构人员选择界面注：如果传入参数为空默认为1C.1.4.4返回数据返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。C.2统一认证服务设计C.2.1远程系统登录验证C.2.1.1服务描述提供给第三方开发商，提供给第三方调用，进行用户密码认证，认证需要调用客户端的API方法进行验证，系统会对验证过程中的用户名密码等相关参数进行签名和命名重写，保证传输过程中的数据安全，安全规则遵行本标准附录B.4登录安全规范执行。统一认证支持自定义登录页面，指的是业务系统采用自己的登录界面，与后端认证服务器进行通信进行认证和创建票据。自定义登录页面的认证过程和统一认证登录界面的认证过程一样，业务系统需要调用SDK包中的客户端认证方法即可。DB52/T1261—2018C.2.1.2服务地址请求方式：GET，请求地址：/api/gov/org/remoteLogin?sign=&token=。C.2.1.3请求参数说明表C.5参数表是是是是是C.2.1.4返回数据返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。<?xmlversion="1.0"encodinC.3统一日志服务C.3.1日志信息推送C.3.1.1请求说明请求方式：POST，请求地址：/api/base/log/push?sign=&token=。C.3.1.2请求包结构体请求包结构体数据是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请求参数说明表C.6参数表是是是否是是是是是是是是是是是是是是是是是是否否否否否否是参数名参数类型说明否否备注字段1否备注字段2否备注字段3否否备注字段5否预留C.3.1.4响应格式返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。C.3.1.5响应格式说明参数名参数类型说明是是状态信息，一般用来标识错误信息C.4统一消息提醒服务C.4.1消息提醒推送C.4.1.1请求说明请求方式：POST,请求地址：/api/base/message/push?sign=&token=。C.4.1.2请求包结构体请求体为一个XML文档，结构如下。<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>消息内容可不能带有HTML标签哦,最长不要超过250个C.4.1.3请求参数说明是是发布时间,立即发布的可以省略,否则为C.4.1.4响应格式返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。C.4.1.5响应格式说明参数名参数类型是否必须说明是是状态信息，一般用来标识错误信息C.5统一参数服务C.5.1获取系统参数请求方式：GET,请求地址：/api/base/param/getParam?sign=&token¶mkey=¶mtype=。C.5.1.2请求参数说明参数名参数类型是否必须说明是请求参数签名是调用token凭证是是参数类型C.5.1.3响应格式返回数据是JSON格式的字符串，需要自行解析处理。示例格式如下。{"mesage":"成功",}DB52/T1261—2018C.5.1.4响应格式说明是是是C.6统一待办服务C.6.1统一令牌服务C.6.1.1获取token令牌C.请求说明请求方式：GET，请求地址：/api/base/token/getToken?sign=。C.请求包结构体请求包结构体数据是XML格式的字符串，需要自行构建处理。示例格式如下。<?xmlversion="1.0"encodin<client-time>2014-07-1012:23:32</c<key>aabbccddeeff001122C.请求参数说明是是是是C.响应格式返回数据是XML格式的字符串，需要自行解析处理。示例格式如下。<?xmlversion="1.0"encodinC.响应格式说明参数名参数类型说明是是状态信息，一般用来标识错误信息是获得的授权码，这个授权码可以在10分钟内使用。DB52/T1261—2018（规范性附录）政务业务事项服务设计D.1台账信息服务设计D.1.1个人台账推送D.1.1.1请求说明请求方式：POST，请求地址：/api/gov/ledger/push?sign=&token=。D.1.1.2请求包结构体返回数据是JSON格式的字符串，需要自行解析处理，示例格式如下。{}D.1.1.3请求参数说明参数名参数类型说明是请求参数签名是内容的标题，不能带HTML标签，也不能台账内容台账日期，台账属于哪天的台账所属人台账所属人姓名台账创建人台账创建人姓名创建时间，必须是yyyy-mm-ddHH:ii:ss格式D.1.1.4响应格式返回数据是JSON格式的字符串，需要自行解析处理，示例格式如下。{DB52/T1261—2018D.1.1.5响应格式说明参数名参数类型是否必须说明statusString是成功为ok,否则为errmessageString是状态信息D.2通知公告服务设计D.2.1通知公告推送D.2.1.1请求说明请求方式：POST，请求地址：/api/gov/notice/push?sign=&token=。D.2.1.2请求包结构体D.请求包内容及其附件采用zip压缩成一个压缩包提交到数据服务器,实现数据推送.只要按照预定格式压缩,一次可以推送多条信息。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来标识文件字符集,type来标<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<!--接收部门，在只发给某单位下一些特有的部门时使用，可以有多个--><reciept-department>54567586876</reciept-dep<!--接收人，只发给具体的人时使用，可以有多个--><reciept-user>325435353464</reciept-user><reciept-user>325435353465</reciept-<attachmentfile="attachment01.rar"title=“附件标题”info="附件描<attachmentfile="attachment02.rar"title=“附件标题”info="附件描述”>·DB52/T1261—2018是是notification表示一条通知公告,可以有多个的不同信息具有不同的标识,同一条信息必须一致,当多次推同一个标识的信息过来后,后面的会替换掉前面的信息.开始时间，必须是yyyy-mm-ddHH:i结束时间，必须是yyyy-mm-ddH接收部门，在只发给某单位下一些特有的部门时<contentfile="content.txt"encoding="utf-8"type="te<attachmentfile="attachment01.rar"title="附件标题"inD.2.1.4响应格式返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。<?xmlversion="1.0"encoding="UTF-8"?><documentguid="contentguid3"status="已发布"/>·D.2.1.5响应格式说明参数名参数类型是否必须说明是是状态信息，一般用来标识错误信息是只有status为ok时，有这个结点是推送内容的详细处理结果。1.guid对应推送内容的guid,2.status为处理结果，一般处理结出错，当为出错时，属性message表示简单的出错信息DB52/T1261—2018D.3文档转换服务设计D.3.1文档在线预览D.3.1.1请求说明请求方式：GET，请求地址：/api/gov/docTrans/preview?sign=&token=&docurl＝。D.3.1.2请求参数说明是是是D.3.1.3响应格式返回数据是JSON格式的字符串，需要自行解析处理。示例格式如下。{}D.3.1.4响应格式说明是是是D.4门户推送服务设计D.4.1查询可推送栏目D.4.1.1请求说明请求方式：GET,请求地址：/api/gov/portal/getcolumns?sign=&token=。D.4.1.2响应格式返回数据是XML格式的字符串，需要自行解析处理，示例格式如下。<?xmlversion="1.0"encoding="·D.4.1.3响应格式说明参数名参数类型说明是是是是具体栏目是是DB52/T1261—2018D.4.2推送数据到栏目D.4.2.1请求说明请求方式：POST，请求地址：/api/gov/portal/push?sign=&token=&sourceid=12&duplicate=ignore。D.4.2.2请求包结构体提交过来的是一个压缩文件，压缩文件里必须拥有一个manifest.xml文件,这个文件用来描述推送信息要素，一个简单的manifest.xml文件示例格式如下。<?xmlversion="1.0"encodin<important-level>普通</import<link-url>/test/test.htm<datetime>2014-06-1412:23:21<encoding来标识文件字符集,type来标<contentfile="content.txt"encoding="utf-8"type="text<attachmentfile="attachment01.rar"title="附件标题"info<attachmentfile="attachment02.rar"title="附件标题"infoD.4.2.3请求参数说明参数名参数类型说明是请求参数签名是是否用：ignore(忽略，默认值),update(更新)这是推送信息文档的根结点表示一条内容信息，可以有多个document标签，实现一次性推送多条信息。内容的标题，不能带HTML标签，也不能省略，信息唯一标识符，长度不超过16位的字母+数字组成的字符串，从同一个业务系统同的标识，同一条信息必须一致，当多次推同一个标识的信息过来后，后面的会替换掉前面的信息。重要级别，一般分为：普通，急件，特急，特提.可以省略，链接地址，一般用来直接到业务系统进行访问的地址，通常情况下应该是不时间，一般为发布时间，必须是yyyy-mm-ddHH:ii:这是通知公告内容，可以带HTML标签，也可以放在单独的文