《一体化政务服务平台电子证照应用规范.docx》由会员分享，可在线阅读，更多相关《一体化政务服务平台电子证照应用规范.docx（19页珍藏版）》请在三一办公上搜索。
1、一体化政务服务平台电子证照应用规范1范围本标准规定了XX省一体化政务服务平台电子证照共享服务的接入要求、数据接口和接口服务说明等应用规范。本标准适用于国家电子证照共享服务系统、XX省各电子政务系统对本省电子证照的检索、下载、获取、验证、模板信息获取和二维码生成。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T36901电子证照总体技术架构GB/T36902电子证照目录信息规范GB/T36903-2018电子证照元数据规范GB/T36904电子证照标识规范GB/T
2、36906电子证照共享服务接口规范ZWFWC0124国家政务服务平台电子证照跨区域共享服务接入要求ZWFWC0123国家政务服务平台证照类型代码及目录信息GB/T13000信息技术通用多八位编码字符集（UCS）GB18030信息技术信息交换用汉字编码字符集基本集的扩充3术语和定义GB/T36901、GB/T36902、GB/T36903、GB/T36904、ZWFWC0123、ZWFWC0124界定的以及下列术语和定义适用于本标准。3.1电子证照照面electroniccertificateinformation电子证照可视内容的直接表现形式，可以包含文本、表格、图像等形式的内容，与实体证照保
3、持一致。4缩略语以下缩略语适用于本文件。：超文本传输协议（HyperTextTransferProtocol）5业务逻辑要求5.1 总体要求XX省一体化政务服务平台电子证照系统为国家政务服务平台或XX省内政务服务人员（或其所使用的应用系统）提供电子证照调阅服务。5.2 电子证照调阅请求逻辑XX省内政务服务人员在办理业务时，按照事项要求调阅证照时，向XX省一体化政务服务平台电子证照系统发起调阅电子证照请求。国家政务服务平台需要调阅XX省的电子证照时，向XX省一体化政务服务平台电子证照系统发起调阅电子证照请求。5.3 电子证照调阅请求分发逻辑XX省一体化政务服务平台电子证照系统收到证照调阅要求时，
4、判断需要调阅的证照是否为本省电子证照。如果是，则查询相关证照数据；如果否，则向国家政务服务平台（资源共享服务中心）发起证照调阅请求。5.4 电子证照数据接收逻辑XX省一体化政务服务平台电子证照系统接受国家政务服务平台（资源共享服务中心）返回的请求结果（证照数据）。5.5 电子证照数据返回逻辑XX省一体化政务服务平台电子证照系统获得调阅请求所需的请求结果（证照数据）后，把证照数据返回给发出该调阅请求的XX省内政务服务人员（或其所使用的应用系统）或国家政务服务平台（资源共享服务中心）。6服务接口要求6.1 总体要求XX省一体化政务服务平台电子证照系统通过XX省一体化政务服务平台和授权的移动端提供电
5、子证照应用服务。电子证照共享服务提供的服务接口见表1。表1电子证照共享服务接口列表序号服务服务提供方服务使用方1电子证照检索服务XX省一体化政务服务平台电子证照系统国家政务服务平台、XX省电子证照相关应用系统2电子证照下载服务XX省体化政务服务平台电子证照系统国家政务服务平台、XX省电子证照相关应用系统3电子证照信息获取服务XX省一体化政务服务平台电子证照系统国家政务服务平台、XX省电广证照相关应用系统4电子证照验证服务XX省一体化政务服务平台电子证照系统国家政务服务平台、XX省电子证照相关应用系统各接口请求方式为，请求类型为POST。接口调用请求和响应使用GB/T13000规定的字符，其中汉
6、字部分使用GB18030规定的字符。因国家政务服务平台接口调整时，XX省一体化政务服务平台电子证照系统接口应及时调整。6.2 电子证照检索服务本接口根据持证主体和其他信息查询该主体所属的证照（标识）列表。接口参数要求见表2。表2电子证照检索服务接口参数要求参数类型参数名必选类型说明输入参数head,accountld是字符串账号ID（由XX省体化政务服务平台统分配）head.accessToken是字符串身份认证信息（由XX省一体化政务服务平台统一分配）data.CertificateHolderCode是字符串证照持有主体代码（如：公民身份号码、统一社会信用代码）data.Certifica
7、teHolderType否字符串证照持有主体代码类型（详见GB/T36903-2018附录A）data.CertificateType否字符串证照类型名称data.useFor是字符串查询事由（01：共享应用：02：亮证应用；03：证照核验：99：其他）输出参数head,message字符串接口执行代码head,status-字符串接口执行说明data.CertificatelD-字符串电子证照标识data.CertificateType字符串证照类型名称data.LssueDept-字符串颁发单位data.CertificateNumber字符串证照编号data.IssueDate-字符串证
8、照颁发时间（yyyy年MM月DD日）6.3 电子证照下载服务通过持证主体代码、证照标识或二维码申请下载电子证照文件。6.3.1基于持证主体代码申请下载电子证照文件接口本接口通过持证主体代码和证照类型名称获取电子证照原件或加注件的下载地址，接口参数要求见表3.表3基于持证主体代码申请下载电子证照下载服务接口参数要求参数类型参数名必选类型说明输入参数head.Accountld是字符串账号ID（由XX省一体化政务服务平台统一分配）head.AccessToken是字符串身份认证信息（由XX省一体化政务服务平台统一分配）data.CertificateHolderCode是字符串证照持有主体代码（如
9、：公民身份号码、统一社会信用代码）data.CertificateHolderType否字符串证照持有主体代码类型（详见GB/T36903-2018附录A）data.CertificateType是字符串证照类型名称data,certifiCateNumber否字符串证照编号data.useFor是字符串下载事山（01：共享应用；02：亮证应用；99：其他）输出参数head,message-字符串接口执行代码head,status-字符串接11执行说明data.CertificateType-字符串证照类型名称data,issueDept-字符串颁发单位data,certificateNumb
10、er-字符串证照编号data.IssueDate字符串证照颁发时间（yyyy年MM月DD日）data,fiIeFormat-字符串证照文件格式data,fiIeUrl字符串文件下载地址6.3.2基于证照标识申请下载电子证照文件接口本接口通过证照标识获取电子证照原件或加注件的下载地址，接口参数要求见表4。表4基于证照标识申请下载电子证照下载服务接口参数要求参数类型参数名必选类型说明输入参数head,accountld是字符串账号ID（由XX省一体化政务服务平台统一分配）head.accessToken是字符串身份认证信息（由XX省一体化政务服务平台统一分配）data.CertificateID是
11、字符串电子证照标识（通过电子证照检索服务获得）data.useFor是字符串下载事由（01：共享应用；02：亮证应用；99：其他）输出参数head,message-字符串接口执行代码head,status-字符串接口执行说明data.CertificateType-字符串证照类型名称data.IssueDept-字符串颁发单位data,certificateNumber-字符串证照编号data,issueDate-字符串证照颁发时间（yyyy年MM月DD日）data,fIleFormat-字符串证照文件格式data.fiIeUrl-字符串文件下裁地址6.3.3基于二维码申请下载电子证照文件接口
12、通过扫描二维码获取到证照加密标识，通过加密标识下载本接口通过证照标识获取电子证照原件或加注件的下载地址，接口参数要求见表5。表5基于二维码申请下载电子证照下载服务接口参数要求参数类型参数名必选类型说明输入参数head,encryptedld是字符串账号ID（由XX省一体化政务服务平台统一分配）head.accessToken是字符串身份认证信息（由XX省一体化政务服务平台统一分配）data,encryptedld是字符串电子证照加密标识（通过关联服务获得）data.useFor是字符串卜载事由（01：共享应用；02：亮证应用；99：其他）输出参数head,message-字符串接口执行代码he
13、ad.status-字符串接II执行说明data.CertificateType-字符串证照类型名称data,issueDept-字符串颁发单位data,certificateNumber-字符串证照编号data,issueDate-字符串证照颁发时间（yyyy年MM月DD日）data,fiIeFormat-字符串证照文件格式data.fileUrl-字符串文件下载地址6.4电子证照信息获取服务本接口通过持证主体代码或证照标识杳询获取证照元数据或照面数据。6.4.1基于持证主体代码获取证照信息服务接口本接口通过持证主体代码查询获取证照元数据或照面数据。接口参数要求见表6。表6基于持证主体代码获
14、取证照信息服务接口参数要求参数类型参数名必选类型说明输入参数head,accountId是字符串账号ID（由XX省体化政务服务平台统分配）head.accessToken是字符串身份认证信息（由XX省体化政务服务平台统一分配）data,certificatellolderCode是字符串证照持有主体代码（如：公民身份号码、统社会信用代码）data.CertificateIIolderType否字符串证照持有主体代码类型（详见GB/T36903-2018附录A）data.CertificateType足字符串证照类型名称data,certificateNumber否字符串证照编号data.use
15、For是字符串查询事由（01：共享应用：02：亮证应用：99：其他）输出参数head,message-字符串接口执行代码head,status-字符串接口执行说明data.CertificateType-字符串证照类型名称data.CertificateName-字符串证照名称data.CertificateHolder-字符串持证主体data.CertificateHolderCode-字符串证照持有主体代码（如：公民身份号码、统一社会信用代码）data,certifiCateHolderType-字符串证照持有主体代码类型（详见GB/T36903-2018附录A）data.IssueDep
16、t-字符串证照颁发机构data.CertificateNumber一字符串证照编号data.IssueDcptCode一字符串证照颁发机构代码data.IssueDate-字符串证照颁发时间（yyyy年MM月DD日）data.CertificateValidateStart-字符串证照有效期起始日期data.CertificateValidateEnd-字符串证照有效期截止日期data.digitalSign一字符串电子证照结构化数据的数字签名Surfaced-JSONArray证照照面信息（参数要求见表7）表7SUrfaCe参数要求参数名类型说明Surface,name字符串照面信息名称Su
17、rface,value字符串照面信息值Surface.ValueType字符串值类型(picture-,string)Surface.ColumnName字符串照面信息名称的英文/拼音缩写6.4.2基于证照标识获取证照信息服务接口本接口通过证照标识查询获取证照元数据或照面数据。接口参数要求见表8。表8基于证照标识获取证照信息服务接口参数要求参数类型参数名必选类型说明输入参数head,accountld是字符串账号ID（由XX省一体化政务服务平台统一分配）head.accessToken是字符串身份认证信息（由XX省体化政务服务平台统一分配）data.CertificateID一字符串电广证照标
18、识（通过电子证照检索服务获得）data.useFor是字符串卜载事由（01：共享应用；02：亮证应用；99：其他）输出参数head,message-字符串接口执行代码head,status-字符串接口执行说明data.CertificateType-字符串证照类型名称data.CertificateName-字符串证照名称data.CertificateHolder-字符串持证主体data,certificateHo1derCode-字符串证照持有主体代码（如：公民身份号码、统一社会信用代码）data.CertificateHolderType-字符串证照持有主体代码类型（详见GB/T3690
19、3-2018附录A）data.IssueDept-字符串证照颁发机构data.CertificateNumber-字符串证照编号data,iSsueDeptCode一字符串证照颁发机构代码data.IssueDate-字符串证照颁发时间（yyyy年MM月DD日）data.CertificateValidateStart-字符串证照有效期起始日期data.CertificateValidateEnd-字符串证照有效期截止日期data.digitalSign-字符串电广证照结构化数据的数字签名Surfaced-JSONArray证照照面信息（参数要求见表7）6.4.3加密电子证照标识信息获取服务接
20、口本接口通过证照类型代码及授权人提供的证照编号查询证照信息及加密电子证照标识数据。接口参数要求见表9。表9加密电子证照标识信息获取服务接口参数要求参数类型参数名必选类型说明输入参数head,accountld是字符串账号ID（由XX省一体化政务服务平台统一分配）head.accessToken是字符串身份认证信息（由XX省一体化政务服务平台统一分配）data.CertificateID是字符串电子证照标识（通过电子证照检索服务获得）data.useFor是字符串下我事由（01：共享应用；02：亮证应用：99：其他）输出参数head,message-字符串接I1执行代码head,status-字
21、符串接口执行说明data.CertificateType-字符串证照类型名称data,certifiCateName-字符串证照名称data.CertificateHolder-字符串持证主体data,certificatellolderCode-字符串证照持有主体代码（如：公民身份号码、统一社会信用代码）data.CertificateHolderType-字符串证照持有主体代码类型（详见GB/T36903-2018附录）data,iSSueDcpt-字符串证照颁发机构data,certificateNumber-字符串证照编号data,iSsueDeptCode-字符串证照颁发机构代码da
22、ta,issueDate-字符串证照颁发时间（yyyy年MM月DD日）data.CertificateValidateStart一字符串证照有效期起始日期data,certificateValidateEnd-字符串证照有效期截止日期data.digitalSign-字符串电子证照结构化数据的数字签名Surface-JSONArray证照照面信息（参数要求见表7）data.CertificateNumber是字符串证照编号6. 4.4加密电子证照标识二维码获取服务接口本接口通过加密电子证照标识获取加密电子证照标识对应的二维码数据。接口参数要求见表10。表10加密电子证照标识二维码获取接口参数要
23、求参数类型参数名必选类型说明输入参数head,encryptedld是String加密的证照标识输出参数-字符串图片二进制流6.5电子证照验证服务本接口根据指定的证照字段内容或二维码，查验该电子证照数据信息的有效性。6.5.1基于字段内容的电子证照验证服务接口本接口根据持证主体代码、证照类型代码以及其他指定的证照字段内容，查验该电子证照数据信息的有效性。接口参数要求见表11。表11基于字段内容的电子证照验证服务接口参数要求参数类型参数名必选类型说明输入参数CertificateHo1derCode是字符串证照持有主体代码（如：公民身份号码、统一社会信用代码）CertificateHolderT
24、ype否字符串证照持有主体代码类型（详见GB/T36903-2018附录A）CertificateData.CertificateType否字符串证照类型名称CertificateData.CertificateName否字符串证照名称CertificateData.CertificateNumber否字符串证照编号CertificateData.certificateHolder否字符串持证主体CertificateData.issueDept否字符串证照颁发机构CertificateData.IssueDeptCode否字符串证照颁发机构代码CertificateData.issueDat
25、e否字符串证照颁发时间（yyyy年MM月DD日）CertificateData.CertificateValidateStart否字符串证照有效期起始日期CertificateData.certificateValidateEnd否字符串证照有效期截止日期UseFor是字符串查询事由（01：共享应用；02：亮证应用：99：其他）输出参数ifResuIt-字符串调用结果（0：调用成功；非0：调用失败）ifResultlnfo-字符串调用结果数据（当ifResult为0时，是业务数据（参数要求见错误！未找到引用源。）；当ifResult为非0时，是错误信息）VerifyResult-字符串验证结果
26、（true或false）msgld-字符串预留6.5.2基于证照版式文件的电子证照验证服务接口本接口根据证照版式文件查验该电子证照数据和电子印章信息的有效性。接口参数要求见表12。表12基于证照版式文件的电子证照验证接口参数要求参数类型参数名必选类型说明输入参数data,fiIeFormat是字符串证照版式文件（pdf或者Ofd格式）data,fiIeEntity是字符串证照版式文件的base64编码输出参数data.dataVerify-字符串详情data,message-字符中照面核验信息data,detail-字符串消息data,result-字符串核验结果（1：成功，0：失败）data
27、.SignVerify-字符串国办返回的签章验证信息6.5.3加密电子证照标识验证服务接口本接口验证加密电子证照标识信息的有效性。接口参数要求见表13。表13基于证照版式文件的电子证照验证接口参数要求参数类型参数名必选类型说明输入参数encryptedld是字符串加密电子证照标识（通过加密电子证照标识信息获取服务获得）输出参数VerifyResult-字符串验证结果（true：成功，false：失败）6.6电子证照注册接口本接口根据对接系统的名称及IP地址获取对应的id与token。接口参数要求见表14.表14基于证照版式文件的电子证照验证接口参数要求参数类型参数名必选类型说明输入参数Syst
28、emName是字符串业务系统名称Systemlp是字符串业务系统地址deptCode是字符串部门编码deptname是字符串部门名称输出参数accountld-字符串账户accessToken-字符串token7服务调用流程要求7.1 应用服务平台XX省一体化政务服务平台通过XX省一体化政务服务平台和授权的移动端提供电子证照应用服务。7.2 应用访问授权政务应用访问XX省一体化政务服务平台电子证照共享服务，需要预先获得XX省一体化政务服务平台授权。对未经授权的应用，XX省一体化政务服务平台可拒绝响应。附录A（资料性附录）电子证照服务接口参数示例A.1基于持证主体代码申请下载电子证照文件接口参数
29、示例输入参数示例：Accounted:PTHLI23,AccessToken:dsadasf12312das2423131dsal23”,CertifiCateHolderCode*/211*435”,“CcrtificateHolderTypez,:“111”,“CertificateType:中华人民共和国居民身份证”，CertifiCateNumber*/211*512”,UseFor:共享应用)输出参数示例：(head:message:接口调用成功”，“status:0，data:total”:1,dataList*:FcertificateType：中华人民共和国居民身份证”，iss
30、ueDept:*市公安局，certificateNumberz,:“211*512”,z,issueDate*:2019年11月11日“，“fiIeUrl:/59.225.209.134:8080/sw/api/prof7c72fe81-a08d-402e-943a-b958d26dc770fileservice7fileName=file7efaf8a8-04e7-47d2-8446-10aef7491421.pd,*fiIeFormat*:pdf”A.2基于证照标识申请下载电子证照文件接口参数示例输入参数示例：Accounted:PTHLI23”,“AccessToken”:dsadasf
31、12312das2423131dsa123,CertificateIDUseFor:共享应用”)输出参数示例：(head”:message:接口调用成功”，“status:0,data”:total”:1,dataList*:CcertificateType”:中华人民共和国居民身份证，issueDept:*市公安局，“certificateNumber,z:“211*512”,TssueDate:2019年11月11日“，“filcUrl:/59.225.209.134:8080/sw/api/prof/7c72fe81-a08d-402e-943a-b958d26dc770fileserv
32、ice7fileName=file7efaf8a8-04e7-47d2-8446-10aef7491421.pd,“fiIeFormat:pdf”)A.3基于二维码申请下载电子证照文件接口参数示例输入参数示例：encryptedld*:*dEvURRjeIQVAxz66KH0m91Yw/d0qduSIu6eljaZHzltvbWHnYtp654bN5xkNWyiUuSsuirBTXdrq0x2mAcKxMd+ynQC5gc5HjzMUb569q7o=*输出参数示例：head”:message:接口调用成功”，“status:0，data”:total”:1,“dataList”:Ccertif
33、icateType”:中华人民共和国居民身份证，“issueDept:*市公安局，“certIficateNumber*:211*512”,*issueDate*:2019年11月11日“，fileUrK:：59.225.209.134:8080/sw/api/prof7c72fe81-a08d-402e-943a-b958d26dc770fileservice7fileName=file7efaf8a8-04e7-47d2-8446-10aef7491421.pd,“fiIeFormat:pdf”1A.4基于持证主体代码获取证照信息服务接口参数示例输入参数示例：AccountId:PTHLI
34、23”,“AccessToken:dsadasf12312das2423131dsal23”,yyCertificateHolderCcrtifiCateHolderType:211*435”,CertificateType:中华人民共和国居民身份证，CertificateNumber:211*;*512”,UseFor:共享应用)输出参数示例：head”:message:接口调用成功”，“status:0，data”:total”:1,z,dataList:CcertificateType”:中华人民共和国居民身份证，certificateName:居民身份证”，zrCertificateH
35、older*:*X*,“certificatello1derCode:211*435”,*certificateHolderTypezz:111”,FssueDept:“*市公安局”,iSsueDeptCode:06*88,certificateNumber:211*512”,zrissueDate*:2019年11月11日”，“CertificateValidateStart:0003年1月1日“，“certifiCateValidateEnd:2021年7月30日，surface:z,coIumnNamezx:KZ-FaZhengRiQi,name”:发证日期，value”:2019-Il
36、-I1”,ValueType:string，z,columnNamez,:zzKZ-YouXiaoQiXianQi*,“name:有效期限起，value:,z0003-01-01,1T人ValueType:string,columnName:KZ_YoUXiaOQiXianZhi”,name:有效期限止“，“value:2021-07-30，ValueType:string，“columnName”:yzKZeChuShengRiQi*,name:出生日期,“value:1994-09-14”,ValueType:string，z,columnNamez,:/zKZ_ShenFenZhengH
37、aoMa/，,“name”:身份证号码”，value:21l*s*c*512”ValueType:string，z,columnNamea,:“KZ_ZhaoPian”,name:照片，value:,z,ValueType*:“picture”,“columnName:KZ_XingBie，name”:性别，“value:男，1TAValueType:string,“coIumnNamc:KZXingMing”,name:姓名，value:X*”,ValueType:string，z,columnNamez,:zzKZ-QianFaJiGuanz,name：签发机关“，value:“*市公安局
38、，ValueType:string，z,columnNamea,:“KZ_MinZu”,name:民族，value：汉”，1rp“人ValueType:string，“columnName:KZ_ZhuZhi”,name:住址,“value:*省*市，ValueType:string)，detail”:“state：23”,msg:该证照已过期)A.5基于证照标识获取证照信息服务接口参数示例输入参数示例：(AccountId:PTHLI23，“AccessTokerT:,dsadasf12312das2423131dsa123*UseFor:共享应用)输出参数示例：(head”:message
39、:接口调用成功”，“status:0，data”:total”:1,“dataList”:certificateTypc:中华人民共和国居民身份证”，*certificateName*:居民身份证”，“certificateHolder:X*”,“certificatello1derCode:211*435”,“certificatello1derType:111”,“issueDept:*市公安局，“iSsueDeptCode:06*88”,certificateNumber”:z,211*512”,*issueDate*:2019年11月11日”，“CertificateValidateS
40、tart:0003年1月1日“，“certifiCateValidateEnd*:*2021年7月30日，“surface”:“columnName:KZ_FaZhengRiQi,name:发证日期，“value:2O19T1-H”,1T“人ValueType:string,columnName,:*KZ_YouXiaoQiXianQizz,name:有效期限起“，“value”:z,0003-01-01,1TValueType:string,columnNamez:“KZYouXiaoQiXianZhi”,name”:有效期限止，“value:2021-07-301T人ValueType:s
41、tring，zzColumnName*:KZ-ChuShengRiQi”,name:出生日期，value:1994-09T4”,ValueType:string，,columnNamez,:z,KZShenFenZhengHaoMaz,name”:身份证号码”，“value:211*512”,ValueType:string，“co1umnNamc:KZZhaoPian”,11Z2LKname:照片，value:,ValueType:picture,z,columnNamea,:KZ_XingBie”,name:性别，“value:男，1T人ValueType:string，z,coIumnNamezx:KZ_XingMing”,name:
