ICS35.020CCSL80DB3704電子證照共享服務平臺證照數據對接技術規范棗莊市市場監督管理局發布DB3704/T0042—2024 1電子證照共享服務平臺證照數據對接技術規范 2 22規范性引用文件 23術語和定義 24公用服務 54.1接口使用須知 54.2對接須知 54.3接口列表 55字典數據 435.1持證主體代碼類型代碼 435.2接口返回值列表 445.3證照類型列表 44DB3704/T0042—20241本文件按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定起請注意本文件的某些內容可能涉及專利。本文件的發布機構不承擔識別專利的責任。本文件由棗莊市大數據局提出、歸口并組織實施。本文件起草單位：棗莊市大數據中心、南威軟件股份有限公司。本文件主要起草人：陳夫真、趙瑞欣、趙榮、陳亞楠、郗金鑫、苗媛媛、王振、孫竹梅、韓幫冉、褚萌、馬亮。本文件為首次發布。DB3704/T0042—20242電子證照共享服務平臺證照數據對接技術規范本技術規范設計是為了規范第三方業務系統如何生成、管理、查詢、獲取電子證照，如網上辦事大廳、行政審批系統、辦公或頒證業務系統等，接口支持多種開發語言的接入，定義統一的數據對接標準，提供可靠性、安全性、規范化的接口標準。本規范的閱讀對象是業務系統的軟件開發人員、各項目管理與開發人員。本規范部分接口配套提供基礎的調試DEMO，開發人員可根據實際情況自行擴展DEMO。2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文件,僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB∕T36901-2018電子證照總體技術架構GB∕T36902-2018電子證照目錄信息規范GB∕T36903-2018電子證照元數據規范GB∕T36904-2018電子證照標識規范GB∕T36905-2018電子證照文件技術要求GB∕T36906-2018電子證照共享服務接口規范ZWFWC0123-2018國家政務服務平臺證照類型代碼及目錄信息ZWFWC0124-2018國家政務服務平臺電子證照跨區域共享服務接入要求3術語和定義GB∕T36901-2018、GB∕T36902-2018、GB∕T36903-2018及GB∕T36904-2018界定的以及下列術語和定義適用于本文件。3.1證照由機關、團體、企事業單位頒發的，能夠證明資格或權利等的憑證類文件。注：證照包括證件和執照等。[來源:GB/T36901-2018，3.1]3.2接口角色及分類DB3704/T0042—20243用于接口授權中的角色及接口日志的分類管理，通常根據業務的應用場景定義，分為檢索證照、下載證照、獲取信息、查看證照等。3.3電子證照由計算機等電子設備形成、傳輸和存儲的證照數據文件。[來源:GB/T36901-2018，3.3]3.4證照照面電子證照可視內容的直接表現形式，包含圖像和文字信息兩種形式，與實體證照保持一致。3.5電子證照文件以版式文檔表示的電子證照，該文件既包含照面固定版式效果，又包含證照元數據及標識，并應用密碼技術保障這些內容的真實性和完整性。[來源:GB/T36901-2018，3.4]3.6證照目錄信息揭示電子證照文件主要內容和形式特征的條目信息集合，是證照管理、共享和服務的基本工具。3.7XML可擴展置標語言（eXtensibleMarkupLanguage）。3.8Base64編碼Base64內容傳送編碼被設計用來把任意序列的8位字節描述為一種不易被人直接識別的形式。3.9JSON格式JSON（JavaScriptObjectNotation）是一種輕量級的數據交換格式。易于人閱讀和編寫，可以在多種語言之間進行數據交換。同時也易于機器解析和生成。3.10Token令牌，代表執行某些操作的權利的對象。是一串字符,用于標識用戶的身份和權限,通常包含一些加密信息,以確保其安全性。DB3704/T0042—202443.11RESTful一般指REST，即表述性狀態傳遞（英文：RepresentationalStateTransfer，簡稱REST）是一種軟件架構風格。它是一種針對網絡應用的設計和開發方式，可以降低開發的復雜性，提高系統的可伸縮性。3.12OAuth2.0一種用戶驗證和授權的互聯網標準協議，該協議要么通過組織在資源擁有者和HTTP服務商之間的被批準的交互動作代表用戶，要么允許第三方應用代表用戶獲得訪問的權限。同時為Web應用，桌面應用和手機，和起居室設備提供專門的認證流程。唯一憑證KEY：接口傳輸中用與標識身份的簽名字段；憑證密鑰：與憑證一起使用，用于確認接口調用者身份。3.13認證機制使用憑證+憑證密鑰的方式進行接口認證，除了“4.3.1用戶身份驗證接口”以外的每個接口訪問時都要帶認證信息access_token(簡稱叫token)，此token是通過“4.3.1用戶身份驗證接口”的返回結果中的“access_token”參數獲取的。3.14編碼格式數據的接收與發送統一使用UTF-8編碼。3.15數據規約接口數據傳輸使用JSON格式，數據的提交使用HTTP協議的POST標準。數據返回包含有消息頭head如下示例：{"head":{"message":"獲取成功","status":0},"data":{3.16服務類型電子證照國標共享服務：根據電子證照國家標準中的共享服務接口規范提供的相關接口。3.17服務方式a）推薦通過共享服務系統發布為Webservice或RESTful服務；b）RESTful服務直接調用。DB3704/T0042—202454公用服務4.1接口使用須知電子證照共享服務接口以GB/T36901-2018中指出的電子證照系統與業務系統之間的交互關系為應用場景，電子證照系統是共享服務的提供方，業務系統是共享服務的調用方。4.2對接須知a)由業務部門向共享平臺申請接口權限，審批后接口發給電子證照項目組開通權限；b）系統根據部門申請信息分配username（訪問標識）、password（應用認證信息），并郵件發送至對接單位的相關人員；c）業務部門對接時向電子證照項目組索要訪問地址的IP和port端口號。4.3接口列表4.3.1用戶身份驗證接口接口說明：此接口用于獲取access_token串,其他接口都需要此接口返回的token作為入參。調用路徑：http://ip:port/license-api-release/oauth/token接口調用請求說明：http請求方式:POST參數說明：是是是是username是password是返回說明:返回access_token串。使用返回的access_token的值做為其他接口的access_token的入參值。本接口負責對調用方的權限及身份進行認證，通過身份認證后將獲取到一個身份驗證串（有效期12小時），調用方使用該身份驗證串就可以調用相應權限的接口。證照共享相關接口。{"access_token":"f54922eb-62da-43df-acee-c2e7d69b0a9c","refresh_token":"bc2d74f1-88ad-42ad-af9d-12b4d57d16bf",6}4.3.2證照標識獲取下載地址接口接口說明：根據電子證照標識和事由、有效期等信息生成電子證照加注件并返回下載地址，同時該下載地址有時效控制，默認10分鐘。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareDownloadUrl接口方式HTTP+JSON請求方式：POST編碼類型：UTF-8調用參數是是否“yyyy-MM-dd”,如“2021-08-26”是是用是是是7否否否省級接口返回結果說明：(1)當返回結果為省級接口返回數據時如下:{"message":"接口調用成功！","status":"0""dataList":[{"certIdentifier":"005.2.1110000000001332XW002.11370000004504679L.3F354BEBEE9D4D1C8AACDD820D9A6DF8.001.O","contentType":"http","content":"http://ip:port/CertShare/zzgxpt/download?id=fe7d0b138e6848bc88268a950aa6d005"}]}}失敗返回：{"message":"接口調用失敗！","data":"證照源未提供此服務接}(2)返回參數說明8錯誤碼；0.成功;其他.失敗，詳見5.2接口返回值列表取值為“http”或“https”備注：省里的身份證數據返回值是一個url,此url訪問后是pdf。市級接口返回結果說明(1)當返回結果為市級接口返回數據時如下:{"message":"接口調用成功","status":"0""dataList":[{"issueDept":"證照頒發機構","certificateNumber":"證照編號","fileUrl":"http://ip:port/license-api-release/elssp/v1/download_national?fileId=emZ2M3Jwd0EwTlFqSjRlSzBpZUI3nlLU0ZoUTlLdHVmR3RRTGhrTEZhTUZaN1VOa2xHRWtFODR4QWVTS1FnNg==&fileFormat=OFD","issueDate":"2013年09月24日","fileFormat":"OFD","certificateType":"證照類型名稱"}]}}(2)返回參數說明94.3.3證照標識獲取證照信息接口接口說明根據電子證照標識獲取該證照的信息內容。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfo接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數是DB3704/T0042—2024是否默認0是是是是是否否否省級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"certno":"37082619880XXXXXXX","gmsfhm":"37082619880XXXXXXX","cert_identifier":"005.2.11100010000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]DB3704/T0042—2024}}(2)返回參數說明市級接口返回結果說明(1)當返回結果為市級接口返回數據時如下:{"message":"接口調用成功","status":"0""dataList":[{"certificateHolder":"陳xx","certificateValidateStart":"2013年09月23日","certificateValidateEnd":"2016年09月22日","issueDept":"XX市無線電管理處","certificateName":"中國XXXX操作證書","certificateHolderType":"111","certificateNumber":"A000002576","issueDeptCode":"12370400F49201558F","certificateHolderCode":"37040319XXXX1209","detail":[],"issueDate":"2013年09月23日","digitalSign":"","certificateType":"中國XXXX操作證書"}]}}(2)返回參數說明4.3.4證照類型代碼驗證證照信息接口接口說明根據持證主體代碼、證照類型代碼以及其他指定的證照信息內容，查驗電子證照有效性。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareVerifyCertInfo接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數參數名稱類型是否必填描述信息是是是是是否默認0否否否省級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"result":0,"message":"信息正確且有效"}]}}(2)返回參數說明據校驗結果，返回0表示校驗正確，其他值表示失敗市級接口返回結果說明(1)當返回結果為市級接口返回數據時如下:{"message":"接口調用成功","status":"0""verifyResult":"true"}}(2)返回參數說明4.3.5證照類型代碼驗證證照文件接口DB3704/T0042—2024接口說明根據提供的電子證照原件或加注件，驗證電子證照文件真實性、電子證照文件完整性及電子證照有效性。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareVerifyCertInfo接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數是是是是是否否DB3704/T0042—2024否否(1)返回結果如下:{"status":0,"message":"接口調用成功""data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}(2)返回結果說明校驗結果，返回0表示驗證通過，其他值表示失敗4.3.6二維碼獲取證照信息接口接口說明根據證照二維碼獲取該證照的信息內容。DB3704/T0042—2024調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfoByQRcode接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數是是否默認0是是是是是否否DB3704/T0042—2024否否whose否否否否否否否否否省級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"certno":"3708261988XXXX0414","gmsfhm":"3708261988XXXX0414","cert_identifier":"005.2.11100000000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]}}DB3704/T0042—2024(2)返回參數說明電子證照照面信息,此接口返回cert_identifier（證照標識可以市級接口返回結果說明(1)返回結果如下:{"message":"查詢成功","status":0"img_sign_fileid":"5b301b493d456b397cf87187","license_name":"中國XXXX操作證書","fileNumber":"02-12370400F49201558F-5100-A000102935","issue_unitname":"XX市XXX局","valid_time_begin":"2017-11-15","holder":"張XX","license_state":"正常有效","valid_time_end":"2020-11-14","licenseId":"46b820f3ed3140da864b9850d4953389","abstractCode":"5cgedf2j6","license_number":"37082619880430XXXX"}}(2)返回參數說明4.3.7證照持有主體代碼獲取證照信息接口接口說明根據持證主體代碼獲取該證照的信息內容。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfoByHo接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數是是是DB3704/T0042—2024是否否否否否否默認0是是是是是否否否否whose否否否否否否否調用區（市市中區、薛城區、嶧城區、臺兒否否DB3704/T0042—2024省級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"certno":"3708261988XXXX1234","gmsfhm":"3708261988XXXX1234","cert_identifier":"005.2.11100000000013127D101.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]}}(2)返回參數說明市級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"certificateHolder":"劉XX","certificateValidateStart":"2014年12月23日","certificateValidateEnd":"2017年12月22日","issueDept":"XXX市XXX區","certificateID":"02-12370400F49201558F-51-370481XXXX240910-00-A000032280","certificateName":"中國XXXX操作證書","certificateHolderType":"111","certificateNumber":"A000032280","issueDeptCode":"12370400F49201558F","certificateHolderCode":"370481XXXX240910","detail":[],"digitalSign":"","certificateType":"中國XXXX操作證書"}]}}(2)返回參數說明4.3.8證照持有主體代碼獲取證照下載地址接口接口說明根據持證主體代碼獲取該證照的信息，根據信息生成電子證照加注件并返回下載地址，同時該下DB3704/T0042—2024載地址有時效控制，默認10分鐘。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareDownloadUrlsByHolderCode接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數是是是是否否DB3704/T0042—2024否是是是是是否調用區（市市中區、薛城區、嶧城區、臺兒否否省級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[{"certIdentifier":"005.2.11100000000013127D011.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8","contentType":"http","content":"http://ip:port/CertShare/zzgxpt/download?id=CFD93524173848F3A2ED4AB7A36E7A50"}]}}(2)返回參數說明DB3704/T0042—2024取值為“http”或“https”data.dataList[].cer市級接口返回結果說明(1)返回結果如下:{"message":"接口調用成功","status":"0""dataList":[{"issueDept":"XX市XXX局","certificateNumber":"魯（2020）XX市不動產證明第100XXXX號-02","fileUrl":"http://ip:port/license-api-release/elssp/v1/download_national?fileId=amlZSzdSVng5TmI1bFRvNjdtZTJsQU9POVVEYUg0cVIvNjBNUzh6UUVsdzBsc2E5RDlyMW9MWkVPaDNQSWxYMQ==&fileFormat=OFD","issueDate":"2020年04月06日","fileFormat":"OFD","certificateType":"產權登記"}]}}(2)返回參數說明備注：省里的身份證數據返回值是一個url,此url訪問后是pdf。4.3.9證照文件base64下載接口接口說明根據證照標識獲取基于base64編碼的電子證照副本ofd和圖片下載。調用路徑：http://ip:port/license-api-release/m/v/license/external/api/ShareDownloadFile接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數DB3704/T0042—2024是是否否否是是是是是否否否省市接口返回結果一致(1)返回結果如下:{"message":"接口調用成功！","status":"0""dataList":[DB3704/T0042—2024{"certIdentifier":"005.2.11200000000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8","contentType":"base64","content":"base64字符串"}]}}(2)返回參數說明取值為“http”或“https”片以base64編碼格式的數組返回，按前后頁順序排列，市數據返回：base64字符串，解碼后的內容符合GB/T4.3.10市電子證照庫新增數據到省電子證照庫的通知接口接口說明通過證照文件標識通知市電子證照平臺將電子證照數據新增到省電子證照平臺。應用場景棗莊市電子證照平臺棗莊市電子證照平臺用<電子證照技術規范電子生成證照生成與共享標準服務接口(V2.1.6主線版本)>文檔中的<52.4電子證照照面信息提交接口>進行市庫數據新增成與共享標準服務接口(V2.1.6主線版本>文檔中的<524電子證照照面信息提交接口>進行市庫數據新增調用6.3.10市正常不存在這種情況如果出現這種情況可能是沒有及時通知市電子證照平臺把數據歸集到省里或者數據不符合規定被省里限制了推送根據返回結果中的shengIsExists、shilsExists電子證照庫新增數據到省電子證照庫的通知接口電子證照庫新增數據到皆電子證照庫的通碼獲取證照信存在情況接口市庫有數據棗莊市政務服務平臺http://ip:port/license-api-release/m/v/license/external/api/inser接口方式請求方式編碼類型DB3704/T0042—2024調用參數是是(1)返回結果如下:{"message":"接口調用成功","status":"0""dataList":[{"certIdentifier":"005.2.11100000000013338W006.113704000042365553.VK33PZ9TY58L.001.9"}]}}(2)返回參數說明4.3.11市電子證照庫編輯數據到省電子證照庫的通知接口接口說明通過證照文件標識和省電子證照標識通知市電子證照平臺將已歸集到省電子證照平臺的數據進行編輯操作。應用場景棗莊市電子證照平臺棗莊市電子證照平臺調用<電子證照技術規范電子生成證照生成與共享標準服務接口(V2.1.6主線版本)>文檔中的<5.2.4電子證照面信息提交接口>進行市庫數據新增況可能是沒有及時通知市電子證照平臺把數據歸集到省里或者數據不符合規定被省里限制了推送調用<電子證照技術規范電子生成證照生成與共享標準服務接口(V2.1.6主線版本)>文檔中的<5.24電子證照照面信息提交接口>進行市庫數據編輯shengIsExists、shils知接口調用6.3.10市電子證照庫新增數據到省電子證照庫的通知接口電子證照庫編輯數據到省電子證照庫的通知接口調用6.3.13證照持有主體代碼獲取證照信息和省市數據存在情況接口省庫有數據棗莊市政務服務平臺http://ip:port/license-api-release/m/v/license/external/api/updat接口方式請求方式DB3704/T0042—2024編碼類型UTF-8調用參數是是是兩種獲取方式:(1)返回結果如下:{"message":"接口調用成功！","status":"0"}(2)返回參數說明返回結果說明4.3.12市電子證照庫作廢數據到省電子證照庫的通知接口接口說明通過證照文件標識通知市電子證照平臺將已歸集到省電子證照平臺的數據進行作廢操作。應用場景棗莊市電子證照平臺棗莊市電子證照平臺調用<電子證照技術規范電子生成證照生成與共享標準服務接口(V21.6主線廢數據到省電子證照庫的通知接口棗莊市政務服務平臺http://ip:port/license-api-release/m/v/license/external/api/del接口方式請求方式DB3704/T0042—2024編碼類型UTF-8調用參數是是(1)返回結果如下:{"message":"接口調用成功！","status":"0"}(2)返回參數說明4.3.13證照持有主體代碼獲取證照信息和省市數據存在情況接口接口說明根據持證主體代碼獲取該證照的信息內容和此條數據在省電子證照平臺、市電子自證照的存在情調用路徑：http://ip:port/license-api-release/m/v/license/external/api/shengShiStateInfoDB3704/T0042—2024接口方式HTTP+JSON請求方式POST編碼類型UTF-8調用參數參數名稱類型是否必填描述信息是是是是否否否否否否默認0DB3704/T0042—2024是是是是是否否否否whose否否否否否否否否省級接口返回結果說明(1)返回結果分四種情況,如下:○1.省庫沒有數據,市庫也沒有數據的返回結果:{"shengIsExists":"0","shiIsExists":"0","message":"接口調用成功",DB3704/T0042—2024"status":"0"}○2.省庫有數據,市庫沒有數據的返回結果{"shengIsExists":"1","shiIsExists":"0","message":"接口調用成功！","status":"0""dataList":[{"fzjg":"XX市行政審批服務局","creditcode":"910XXXXXXXX3P038","fundtype":"XX測試","zzyxqqsrq":"2022-04-15","ft1":"/bz/open/qrdetail/license?licenseNo=005.2.11100000000013338W008.XXXXXXXXXXXXXXXXX.AF96FA0FADA24B018FBF0A6E2CEB1FA9.001.H","issuingOrg":"XX市行政審批服務局","orgcode":"1","gmt_modified":"2022-04-2215:47:02.0","certholdercode":"910XXXXXXXX3P038","orglevel":"XX測試","xxdz":"XX測試","zzyxqjzrq":"2027-04-14","certno":"XX變更20220415","ownersfzhm":"","yxq":"2022-04-15","orgname":"XX測試核驗","certholder":"XX測試核驗","zzbfrq":"2022-04-15","bz":"XX測試","cert_identifier":"005.2.11100000000013338W008.XXXXXXXXXXXXX.68QZNXENRXK.001.R"}]}}○3.省庫沒有數據,市庫有