SZSD 0055.3—2024无证明服务 电子证照应用规范 第3部分:共享服务.docx
ICS35.240.30CCS1.65SZSD数字山东工程标准SZSD0055.32024无证明服务电子证照应用规范第3部分:共享服务UncertificatedservicesApplicationspecificationforelectroniccertificatePart3:Sh<redservices2024-06-01实施2024-04-15发布山东省大数据局发布本文件按照GB/T1.1-2020E标准化工作导则第I部分:标准化文件的结构和起草规则3的规定起草,本文件是SZSDOo554无证明限务电子证照应用规范:的第3部分.SZSDOO55已经发布了以卜部分: 第1部分:总体架构; 第2部分:制发服务: 第3部分:共享服务.请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的贵f%本文件由山东省大数据中心提出.本文件由山东省大数据时归口.本文件起草单位:山东省大数据中心、日照市大数据发展局、能州市大数据同、潍坊市大数据中心、里庄市大数据中心、滨州市智达城市指挥运营中心、青岛巾大数据发展管理局、济南市信息中心、淄博市大数据中心、聊城市大数据局、东甘市大数据中心、绿沟网络科技有眼公司。本文件起草人:王茜、殷方勇、封飞虎、李小阳、林冲、张建林、精明、陈夫其、王耀磊、孙敬玲、刘苴、公维喜、吴海龙、史国强、谢兵、胡阳.无证明服务电子证照应用规范第3部分:共享服务1葩围本文件规范了电子证照系统的共享服务模式、共享限务接口等要求,本文件适用于各级各部门用证业务系统的电子证照信息获取、下我、验证、授权等,2规葩性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款,其中,注11期的引用文件,仅该H期对应的版本适用于本文件:不注H期的引用文件.其最新版本(包括所有的修改单)适用于本文件。GB/T36903-2018GIVT369042018GB/T369052018GB/T36906-2018电子证照元数据规范电子证照标识规范电子证照文件技术要求电子证照共享服务接口规范SZSD0030.1-2021无证明极务电子证照应用规范第1部分:总体架构3术语和定义SZSD0030.12024界定的术谙和定义适用于本文件.4缩略语下列缩略谙适用于本文件.JSON:种轻量级的数据交换格式(JaVaSCriPtObjectNotation)HrrP:超文件传输协议<HyperTextTransferProtocol)HTTPS:以安全为目标的HTTP通道,在HTTP的基础上通过传输加密和身份认证保证了传输过程的安全性(HyperTextTransferProtocoloverSecureSocket1.ayer)5共享股务模式5.1 总体要求5.1.1 省市电子证照系统通过提供共享服务,供各级各部门用证业务系统获取电子证照数据.实现办”信息免录入、办小材料免提交。5.1.2 省、市电子证照系统是接口服务的提供方,各级各部门用证业务系统是接口服务的调用方,52省直部门共享应用5.2.1省宜部门用it业务系统兼取省级电子证照数据,应由省电子证照系统提供共享服务支捏.5.2.2省出部门用证业务系统获取市级电予证照数据,应由省市电子证照系统提供共享服务支掠.通参数类至数名称类31必m描述信息输入影故head.HccessldStringi网标识,由电子证照系统分依bond.CcexsT<>krnString应用认近信息.由电子证照乐统生成data,certI<kniifierStringa.电子证照标识,其硒符合出外36901的要求data.useCauseString是申请事由.见M2.“版本号”字段不为空时,该字段沟包含用证系统编科和川证业务编科data,versionString否板本”.固定位为“120”data.certuthCodeStringS证网授权码.Hffi32½U1.ID.当“申请事由”中所传的用证业务名稔及用证业务编积番案为需要用户授权时.证照叔权码字段必地head,statusint锚设码:0.成功:其他.失败输出修数head,mssoggString返网结果说明.Midntn.CertDatnString电子证照照面信必62.2基于证照持证主体代码获取证照信息服务本接口根据持证主体代码获取证照信息.接I参数要求见表3。表3基于证照持证主体代码获取证照信总服务接口参数要求参数类型彭数名称类型必以描述信息输入参数bcnd.nccc!cjdStrinsJi访时标识,由电子皿照系统分配bead.accessTokenString是应用认证信,由电子1£愿系统生成data.holderCodeString是持让友体代码.to:身份证号码、统社会信用代码data,hoIderTypeCodeString是持证主体代囚类型便符合GBZT3颂3的要求.见表B.3data.CertlypeCcdeString是证热类型代码dU.certNoString否证照编号data.us<CiwrString申请事由,见表B.2,“版本号”字段不为空时,该字段须包含川江系统笫码和川W业务编码data,versionString否版本号,BI定值为“¥2.。”<btn.ccrt.uthCodrString否W照授权码,其ffl地32位UUID。当“申请事由”中所位的用证业务幺移及用江业务收网符案为能要用户授权时,证照授权和字段必埴输出参数head,statusint-错误6%0.成功:共他.失败hcnd.11rsx2gcString返国结果说明,见表RIdata,certl)auString-电子证照照面信息6.2.3基于二维码获取证照信息服务本接Il根据:斑:码获取证照信息,接口参数要求见衣1,表4基于二维码获取证照信息服务接口参数要求参数类型参数林类型必地描述信息*certIdentifier":*l.2.156*.001.Q*."content":"/CertShfir。/ZZgXPt/download?id=FD650F70A51B460E97623AA49EF216IE”,"conIenlType":"http*A.7基于证照类型代码验证证照信息接口叁数示例调用路径;hitp:/ip:PortzcertShareZverifyCertInfo输入多数示例:("head":accessld:-5b45930bc7bf42xxx5l7482e7f8c-,“accessToker:"61e18075d12blM3b6033a1d7153f5cb*1."data":"041MFB95943B9RO41939OA37B48A6F2805凶091”data加密商参考示例:(“CerlTywCodeI-l11000000000185265001',“certData":"hoIderCodeI12370xxxx55136992",holder”:山东省XXX活服务处”,“certN。":"1237000xx5436992*.*org11s三:“山东省省级XXX生活服务处需要校验信息issuingrg,:"中共山东省XXX编制委员会办公室”"需要校验伯息*,useCause*:""certificateSyStemXalnC系统"certificateSyste三Code”:*S123456789321*,VCertifiCateMatterNam个人参保缴册证明查询打印',VcertificateEventCode:E987651321098)",“version”:"V2.0”输出参数示例:("head":1“status”:0.SSag“接口调用成功”,data*:*04D4FB95943B9E041939037B48A6F2805F9091data加密前参考示例:"result”:O."message":"信息正确I1.有效”)A-8基于持证主体代码获取证照授权请求标识服务接口参数示例调用路径;httip:port/CertShare/queryAuthRequestIdentifier输入参数示例("head":“accessld”:*appld”.*,accessToken<356YD07xXyb08m11>rTdk7UulnutCJIsOicFrMo1.tzZZzdcE5ZYQ>'FrqryzCD0cNVreU7Ey4GsJAA«8SxOBBlk1."data":"041MFB95943B9E(Ml9390A37B48A6F2805Fy<)9l""data加密前参考示例”:("holderCode":"320152*248021”,*holdorTycCodo*:*111*,"心01115。":”'。11行(:抽。5丫51。111,血?":*系统*,"<:。1"1门:必。0丫510»(?。(1。":飞123456789321","certificateMatterNme个人参保缴费证明查询打印".'"certificateEVentCCdE98765>1321098r,"businessScenariOType:0,""authRequcstSirr,6YD07xXyb08BlbrTdk7,输出参数示例:"head":(status:0,"mossag。":"接口调用成功”I,"data":,04DIFB95913B9E0119390A37B18A6F2805I'9091”data加密前参考示例:“CcrlificaieHoldcrName":"张三",*ccrtifiCatcilolderCode*:"37*92*,*certifiCateHolderT)TPeeode""cerlAuthRequcstIdentifier"J5C10DCFDO7E469BBA716168lEB17C0E”*,certAuthVr1*:*httpsBA7161681EB17C0E*ccrtHoldStatus*:"certificateNw":"中华人民共和国居民身份证”.*holdSlatus:1),ertifiCateName":"中华人民共和国不动产权证书”,*holdStatus*:0)A.9基于证照授权请求标识获取授权结果服务接口参数示例调用路径:hltp"ip:POrtCeriSharoqueryCeriAuthResult输入参数示例"head”:(,accessId*TappId-,acccssTokcn356YDO7xXyb08mlbrTdk7UulnwtCJIs0icFrMo1.tzZZzdcE5ZY<hFrqryzCD0cNVreU7EMGsJAABSSxOBBtg=","da<a":"04D1FB95913B9E(M19390A37B48A6F2805F9091”)"data加密前参考示例":(certAuthRequestIdcntifier":"5CK)DCH)07EA,169BBA7161681EBl7C0E"输出参数示例:("head”:("sialus":0,"message":“接口调用成功”).*data*:*01D1195943B9EOl1939037B186F2805F9O91data加密前参考示例:"certAuthStatus”:1,"certAuthCode”:*BCDFB06FB54252DD0C93271E61I)F*expiredTime*:*2023-09-0710:10:10*A10验证证照授权码接口参数示例调用路径:http:/ip:port/CertShare/veriFyCertAuthCode输入参数示例:("head":(*acccssld":*,appld"1*accessToken":*356YD07xXyb08mlbr/Tdk7Uu1nwtCJIsOiCFrMo1.tzZZzdcE5ZYQ>FrqryzCD0cNVreU7Ey4GsJAA三8SxOBBtg=,'data*:01D4FB95943B9E0119390A37M8A6F2805F9091')"data加密前参考示例Z"holderCode":"320152*248021”,*holdorTycCodo*:*111*,certT>peCode*l1100000000013127DOO.“certIdentifier"*shareInterfacePath-:*/queryCertInfoBylIolderCode*,"useause":""certificateSyste<nNa«e":*系统”,VCerlifiCaleSySteCodeZ"S123456789321*,VCertifiCateMatterNam个人参保激费证明查询打印"."certificateEventCode”:,E9876M321098*,*certAuthCode*:,BCDFB06AFB5F4252DAD0C93271E61DF*)输出参数示例:(*hend*:("status”:0,"message":"接口调用成功”,*data*:*04D4FB95943B9E0419390A37B48A6F2805F9091,data加密前参考示例:(*rcsull*:0,“message”:证照授权码有效”,"certidentifier”:1.2.156.3005.2.*,*1.2.156.3005.2.*A11动态刷新密钥服务接口参数示例谢用路径:http:/ip:port/CertShare/refreshsccret输入参数示例:"head":"accessId":"appId”,*accessToken,*356YD07xXyb08nlbrdk7UulnwtCJWs0icFrJlo1.t2ZZzdcE5ZlQyFrqryzCD0cNVreU7EWGsJAABSSxOBBtg=",*data*:(,requestPaih:"/CertShareZqueryCertInfow,-sign":6<.'897220fb8631983dab8blcada8d88b42a9elOdl560-1978"1输出参数示例:("head":("status”:0,"message、.接口调用成功”,"data*:,01>lFB95913B9E0419390A37M8A6F2805F9091”data加密的参考示例:("PrivateKey":OOC319030E59682167B31B2F5B30470F5F6R1.*,publicKey*re0960C78FFE74EH6BD62CB832288E.*."expired!i三e":"2023-01-0123:59:59"附录8(资料性)字典数据B.1接口返回值接口返I可值字典我见友B.I.表B.1接口返回值列表返网价纲码加科描述0接UiHM成功1第三方接口连接加时2证那稳未提供此服务接“i)未找到一Rd的证11身份一证不通过12要求必埴的输入也数值为空13证黑类型不存在或未发布M错谈的持证主体代码类型21该电子证照已陵止或己注播%该电子证照已过期23该电子证照已受限使用24中请农船的证照数械无法解析99其他片常B2申请事由申请事由字典我见表K2.表B.2申请事由序号警数名参散类型设明1certific*>teSysicfio11M?string系统看林2ccrtifictcSyxtr(*DdcString用if系统蝌闪,坡外现则:SM2位随机数字4ccrtific1.rMattorNitftt?string用i£业务名称4certificatoEventCodestring用IE业务始码.JS码规则:E+12位随机数字B3持证主体代码类型持证主体代码类型字典表见表B.3.表民3持证主体代码类型代翦li,J持证主体类别类别加分持证主体代用类型代码1法人和其他现织法人和其IMfl织统一社会俏用代码0012其他法人或其他组织有效证件代码099序号持证主体类别类别后分持让主体代码类型代码3Tft居民公民身份号囚1:1I军人中国人氏标放军军官证蜗t;IH5中国人民武装警珞部R警官证总号Ih-6中国人民解放军士兵还够号1187中国人民武装警察部队士兵证率119S中国人民解放军文职人员证编U1209中H人民武装警察部队文职人员证新弓12210口所八隼侪卬外籍人士外交护照护照号411H公务护照护照号41212公务智通护照护组号IIJ13普通护照护照号IllIl台汽人士台港区民往大HI通行证号码51115港澳人士港澳居民来往内地通行证号码51616其他其他白然人有效i三件代码999叁考文献1 GB/T369012018电子证照总体技术架构2 GB/T369022018电子证照目录信息规范3山东省人民政府办公厅.关于深化数据赋能建设“无证明之省”实施方案的通%.(httpart202267art107861119316.html),2023-5-26.4山东省大数据局.山东省电子证照管理应用工作规范(第二板).(art202395art33397459933.ht三l),202395.