SZSD 0055.3-2024無證明服務(wù) 電子證照應(yīng)用規(guī)范 第3部分：共享服務(wù)

SZSDUncertificatedservices—Applicationspecificationforelectroniccertificate—I 25.4共享服務(wù)授權(quán) 2 2 2 2 5 6 6.6動(dòng)態(tài)刷新密鑰服務(wù) 9 本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定為促進(jìn)和規(guī)范電子證照在更多領(lǐng)域應(yīng)用并實(shí)現(xiàn)互通互認(rèn)，推進(jìn)“免證辦”“一碼辦”“主動(dòng)辦”，發(fā)〔2023〕5號）等一系列政策文件，對全省電子證照應(yīng)——第1部分：總體架構(gòu)。規(guī)定了省市電子證照系——第2部分：制發(fā)服務(wù)。規(guī)定了電子證照的制發(fā)服務(wù)——第3部分：共享服務(wù)。規(guī)定了電子證照的共享服務(wù)1無證明服務(wù)電子證照應(yīng)用規(guī)范第3部分：共享服務(wù)本文件規(guī)范了電子證照系統(tǒng)的共享服務(wù)模式、共享服務(wù)接口本文件適用于各級各部門用證業(yè)務(wù)系統(tǒng)的電子證照信息獲取、下載、驗(yàn)證、授權(quán)SZSD0030.1—2024無證明服務(wù)電子SZSD0030.1—2024界定的術(shù)語和定義4縮略語JSON：一種輕量級的數(shù)據(jù)交換格式(JavaScriptObjectNotatHTTP：超文件傳輸協(xié)議（HyperTextTransferProtocHTTPS：以安全為目標(biāo)的HTTP通道，在HTTP的基礎(chǔ)上通過傳輸加密和身份認(rèn)證保證了傳輸過程的安全性（HyperTextTransferProtocoloverSecur5.1.1省市電子證照系統(tǒng)通過提供共享服務(wù)，供各級各部門用證業(yè)務(wù)系統(tǒng)獲取電子證照數(shù)據(jù)，實(shí)現(xiàn)辦5.1.2省、市電子證照系統(tǒng)是接口服務(wù)的提供方，各級各部門用證業(yè)5.2.1省直部門用證業(yè)務(wù)系統(tǒng)獲取省級電子證照數(shù)據(jù)，應(yīng)由省電子證照系統(tǒng)提供共享服務(wù)支撐。5.2.2省直部門用證業(yè)務(wù)系統(tǒng)獲取市級電子證照數(shù)據(jù)，應(yīng)由省市電子證照系統(tǒng)提供共享服務(wù)支撐，通25.3.1市級部門用證業(yè)務(wù)系統(tǒng)獲取本市電子證照數(shù)據(jù)，應(yīng)由本市電子5.3.2市級部門用證業(yè)務(wù)系統(tǒng)調(diào)用其他市電子證照數(shù)據(jù)，應(yīng)由省市電子證照系統(tǒng)提供共享服務(wù)支撐，5.3.3市級部門用證業(yè)務(wù)系統(tǒng)調(diào)用省級電子證照數(shù)據(jù)，應(yīng)由省市電子證照系統(tǒng)提供共享服務(wù)支撐，通5.4共享服務(wù)授權(quán)123456基于證照持有主體代碼獲取證照ofd文件下載7基于證照標(biāo)識獲取base64編碼的證照文89本接口根據(jù)證照標(biāo)識獲取證照信息，接口參數(shù)要求3是是是是否版本號，固定值為“V2.0”否證照授權(quán)碼，其值是32位UUID。當(dāng)“ 錯(cuò)誤碼：0.成功；其他.失敗-返回結(jié)果說明，見表B.1-6.2.2基于證照持證主體代碼獲取證照本接口根據(jù)持證主體代碼獲取證照信息，接口參數(shù)要求表3基于證照持證主體代碼獲取證照信息服務(wù)是是是碼是B.3是否是否版本號，固定值為“V2.0”否-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1 本接口根據(jù)二維碼獲取證照信息，接口參數(shù)要4是是是是-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1--是是否是是data.certificateCopyE否否版本號，固定值為“V2.0”否-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1 取值為“base64” -5本接口根據(jù)證照標(biāo)識獲取證照文件的下載地址，接口參數(shù)要是是是是否“版本號”字段不為空時(shí)，該字段必填否版本號，固定值為“V2.0”否-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1 取值為“http”或“https”- 證件文件下載地址，下載后的文件應(yīng)符合GB本接口根據(jù)持證主體代碼獲取證照文件的下載地址服務(wù)，接口參數(shù)要是是是是是否是6否版本號，固定值為“V2.0”否證照授權(quán)碼，其值是32位UUID。當(dāng)“否“yyyy-mm-dd”?！鞍姹咎枴弊侄尾粸榭諘r(shí)，該-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1 取值為“http”或“https”- 6.4.1基于證照類型代碼驗(yàn)證證照是是是是是否版本號，固定值為“V2.0”-錯(cuò)誤碼：0.成功；其他.失敗 返回結(jié)果說明，見表B.1-敗-“2”：“信息正確且證照暫時(shí)失效”“5”：“查無此信息”76.5.1基于持證主體代碼獲取證照授權(quán)請求表9基于持證主體代碼獲取證照授權(quán)請求標(biāo)識是是是是是是是-錯(cuò)誤碼；0.成功;其他.失敗-返回結(jié)果說明，見表B.1data.certAuthRequestI---data.certHoldStatus.c-data.certHoldStatus-6.5.2基于證照授權(quán)請求標(biāo)識獲取授權(quán)根據(jù)授權(quán)請求標(biāo)識獲取用戶授權(quán)狀態(tài)和授權(quán)碼，接口參數(shù)要求見表10基于證照授權(quán)請求標(biāo)識獲取授權(quán)結(jié)果是是8是-錯(cuò)誤碼；0.成功;其他.失敗 -絕--是是否否主體代碼”字段不為空時(shí)，該字段必填否否是是是 錯(cuò)誤碼；0.成功;其他.失敗 返回結(jié)果說明，見表B.1-9-“2”：“證照授權(quán)碼已過期”“3”：“證照授權(quán)碼驗(yàn)證失敗”-該接口是根據(jù)共享接口路徑和簽名信息獲取動(dòng)態(tài)的SM2私鑰和私鑰過期時(shí)間。注：接口出參可使用AES對稱加密算法進(jìn)行解密。接口參數(shù)要求見表12。是是是是 錯(cuò)誤碼；0.成功;其他.失敗-返回結(jié)果說明，見表B.1 -A.1基于證照標(biāo)識獲取證照信息接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/qu{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrqryVreU7Ey4GsJAAm8Sx0BBtg"data":"04D4FB95943B9E0419390A37B48A6}{"certIdentifier":"005.2.11100000000013127D001.x"useCause":"{\"certifi\"S123456789321\",\"certificateMatterName\":\"個(gè)人參保繳費(fèi)證明查詢打印\",\"certificateEventCode\":\"E987654321098"certAuthCode":"BCDFB06AFB5F4252ADA}{"certData":"04D4FB95943B9E0419390A37B48}{}A.2基于證照持證主體代碼獲取證照信息接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/queryCertInfoByHo{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrq"data":"04D4FB95943B9E0419390A37B48A6"holderCode":"320452"certTypeCode":"111000000"useCause":"{\"certificateSystemNa\",\"certificateCallCategory\":\"0\",\"certificateMatterName\":\"個(gè)人參保\",\"certificateEventCode\":\"1137000000450258552372014020002\",\"cert"certAuthCode":"BCDFB06AFB5F4252ADA}{"certData":"04D4FB95943B9E0419390A37B48}A.3基于二維碼獲取證照信息接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/queryCertInfo{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQ"data":"04D4FB95943B9E0419390A37B48A6"qrcode":"sddzzz_7a98799bb6ca4d}{"certData":"04D4FB95943B9E0419390A37B48"opData":"05D4FB95943B9E0419390A37B48A6}{}{"cert_identifier":"1.2.1***3956AAAD45"download_img_url":"/CertShare/zzgxpt/download?id=FD650F7}{"authDateLine":"授權(quán)失效時(shí)間"--格式y(tǒng)yy}A.4基于證照標(biāo)識獲取base64編調(diào)用路徑：http://ip:port/CertShare/d{"accessToken":"356YDO7xXyb0*"data":"04D4FB95943B9E0419390A37B48}{"certificateIdentifier":"1.2.156**6AAAD45"certificateCopyCause":ystemCode\":\"S123456789321\",\"certificateMatterName\":\"個(gè)人參保繳費(fèi)證明查詢打印\",\"certificateEventCode\":\"E987654321098"certificateCopyExpiringTime":"certAuthCode":"BCDFB06AFB5F4252ADA}{"certIdentifier":"}調(diào)用路徑：http://ip:port/CertShare/d{"accessToken":"Gl9"data":"04D4FB95943B9E0419390A37B48}"certIdentifier":"1.2.156"useCause":"{\"certificateSystemNa\",\"certificateCallCategory\":\"0\",\"certificateMatterName\":\"個(gè)人參保",\"certificateEventCode\":\"1137000000450258552372014020002\",\"certificateCo"certAuthCode":"BCDFB06AFB5F4252ADA}"data":"04D4FB95943B9E0419390A37B48}{"certIdentifier":"005.2.1110000000"content":"/CertShare/zzgxpt/download?id=FD650F70A51B460E976}A.6基于證照持證主體代碼獲取證照of調(diào)用路徑：http://ip:port/CertShare/downloadUrlsByH{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrq"data":"04D4FB95943B9E0419390A37B48A6"holderCode":"320452"certTypeCode":"111000000"useCause":"{\"certificateSystemNa\",\"certificateCallCategory\":\"0\",\"certificateMatterName\":\"個(gè)人參保\",\"certificateEventCode\":\"1137000000450258552372014020002\",\"certificatCause\":\"個(gè)人參保繳費(fèi)證明查詢打印\",\"certificateEventCode\":\"E987654321098\""certAuthCode":"BCDFB06AFB5F4252ADAD}{"data":"04D4FB95943B9E0419390A37B48}[{"certIdentifier":"1.2.1"content":"/CertShare/zzgxpt/download?id=FD650F70A51B460E976{"certIdentifier":"1.2.1"content":"/CertShare/zzgxpt/download?id=FD650F70A51B460E976]A.7基于證照類型代碼驗(yàn)證證照信息接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/veri{{"accessId":"5b45930bc7bf42x"accessToken":"61e18075d1214f43b"data":"04D4FB95943B9E0419390A37B}{"certTypeCode":"11100000"holderCode":"12370"issuingOrg":"中共山東省xxx編制委員會(huì)辦公室"--需要校驗(yàn)信息"useCause":"{\"certificate\"S123456789321\",\"certificateMatterName\":\"個(gè)人參保繳費(fèi)證明查詢打印\",\"certif}{"data":"04D4FB95943B9E0419390A37B}{}A.8基于持證主體代碼獲取證照授權(quán)請求標(biāo)識服務(wù)接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/queryAuthRequest{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrq"data":"04D4FB95943B9E0419390A37B48A6"holderCode":"320452"useCause":"{\"certificateSystemName\":\"**系統(tǒng)\",\"certificateSystemCode\":\"S1234789321\",\"certificateMatterName\":\"個(gè)人參保繳費(fèi)證明查詢打印\",\"certificateEventCode"authRequestSign":"6YDO7xXy}{"data":"04D4FB95943B9E0419390A37}{"certificateHolderCo"certificateHolderTy"certAuthRequestIdentifier":"5C10DCFD07EA469BBA716"certAuthUrl":"/auth_h5?authRequestIdentifier=5CBA7161681EB17C0E",{"certificateName":"中華{}}A.9基于證照授權(quán)請求標(biāo)識獲取授權(quán)結(jié)果服務(wù)接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/queryCertA{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrq"data":"04D4FB95943B9E0419390A37B48A6}"certAuthRequestIdentifier":"5C10DCFD07EA469BBA7}{"data":"04D4FB95943B9E}{"certAuthCode":"BCDFB06AFB5F4252ADAD"expiredTime":"2023-09-0710:10:10"}A.10驗(yàn)證證照授權(quán)碼接口參數(shù)示例調(diào)用路徑：http://ip:port/CertShare/verifyCe{"accessToken":"356YDO7xXyb08mlbr/Tdk7UulnwtCJWsOicFrMoLtzZZzdcE5ZYQyFrq"data":"04D4FB95943B9E0419390A37B48A