DB11T 2290-2024 電子證照共享服務(wù)系統(tǒng)接入技術(shù)要求

ICS35.240.01CCSL70

DB11北 京 市 地 方 標(biāo) 準(zhǔn)DB11/T2290—2024電子證照共享服務(wù)系統(tǒng)接入技術(shù)要求Technicalrequirmentsforshareserviceelectroniccertificatesystemaccess2024-06-28發(fā)布 2024-10-01實(shí)施北京市市場(chǎng)監(jiān)督管理局 發(fā)布DB11/T2290—2024目 次前言 III1范引文件 1語(yǔ)定義 1略語(yǔ) 2子照享務(wù)接入 2接內(nèi)容 2接流程 2接方式 3接安全 3子照享務(wù)接口4接內(nèi)容 4安會(huì)接口 4電證目查5電證制接口 6電證操發(fā)7電證持主權(quán)服接口 9電證依能用證11接調(diào)流程 13附錄A（料） 電證照享務(wù)統(tǒng)入15A.1 電證共服統(tǒng)接申15附錄B（料） 安會(huì)話口用16登接調(diào)示例 16退登接調(diào)16獲當(dāng)已錄信息口用16附錄C（料） 電證照錄詢口用18C.1 電證目查口調(diào)示例 18附錄D（料） 電證照證口用19創(chuàng)制數(shù)接用示例 19修制數(shù)接用示例 20刪制數(shù)接用示例 21附錄E（料） 電證照作布口用22簽證接調(diào)22變一證接用示例 23廢一證接用示例 24IDB11/T2290—2024批制證接用示例 24附錄F（料） 電證照證體證務(wù)口調(diào)示例 28統(tǒng)身認(rèn)用口調(diào)示例 28用碼取照接口用28用碼取問(wèn)接口用29用碼檔子接口用30查電證移頁(yè)面口用31附錄G（料） 電證照證務(wù)口用32依能驗(yàn)證調(diào)用32獲證訪令口調(diào)示例 33提證數(shù)接用示例 34查電證頁(yè)口調(diào)示例 34參考獻(xiàn) 35IIDB11/T2290—2024前 言本文按GB/T1.1—2020《準(zhǔn)工導(dǎo)則 第部分標(biāo)化件結(jié)和起規(guī)》起草。本文件由北京市經(jīng)濟(jì)和信息化局提出。本文件由北京市政務(wù)服務(wù)和數(shù)據(jù)管理局歸口并組織實(shí)施。本文件起草單位：北京市大數(shù)據(jù)中心、北京數(shù)字認(rèn)證股份有限公司、中國(guó)電子技術(shù)標(biāo)準(zhǔn)化研究院。本文件主要起草人：朱芳、郭家義、林峰璞、彭雪海、張琳、石志國(guó)、劉旭、陳桂紅、趙琰昉、柳笛、朱蓉華、牟大偉、梁玉晨、陳亞軍、劉文、李佳妮、徐文龍、舒崢。IIIDB11/T2290—2024電子證照共享服務(wù)系統(tǒng)接入技術(shù)要求范圍本文件規(guī)定了電子證照共享服務(wù)系統(tǒng)的接入內(nèi)容、接入流程、接入方式、接入安全以及接口要求。本文件適用于政務(wù)部門存在用證需求的業(yè)務(wù)系統(tǒng)（以下簡(jiǎn)稱業(yè)務(wù)系統(tǒng)）與電子證照共享服務(wù)系統(tǒng)的對(duì)接工作。（GB/T36901 GB/T36906 DB11/T1901 GB/T36901、GB/T36906、DB11/T1901界定的以及下列術(shù)語(yǔ)和定義適用于本文件。證照certificate由機(jī)關(guān)、團(tuán)體、企事業(yè)單位頒發(fā)的，能夠證明資格或權(quán)利等的憑證類文件。：GB/T36901-2018，3.1]certificatecatalog依據(jù)元數(shù)據(jù)規(guī)范對(duì)證照提取特征，并按照一定的分類方法進(jìn)行排序和編碼形成的一組信息。[來(lái)源：GB/T36901-2018，3.2]電子證照electroniccertificate按規(guī)范形式表達(dá)或承載證照信息的電子文件，包含證照模板、證照數(shù)據(jù)和簽章/簽名信息。[來(lái)源：GB/T36901-2018，3.3]電子證照共享服務(wù)系統(tǒng)electroniccertificatesystemforshareservice為政務(wù)部門提供電子證照共享服務(wù)的系統(tǒng)。事項(xiàng)編碼itemcode給政務(wù)部門存在用證需求的事項(xiàng)賦予的代碼。事項(xiàng)名稱itemname對(duì)政務(wù)部門存在用證需求的事項(xiàng)進(jìn)行規(guī)范統(tǒng)一的命名。1DB11/T2290—2024縮略語(yǔ)下列縮略語(yǔ)適用于本文件。API：應(yīng)用程序接口（ApplicationProgrammingInterface）HTTPS：安全的超文本傳輸協(xié)議（HypertextTransferProtocolSecure）JSON：JS對(duì)象簡(jiǎn)譜（JavaScriptObjectNotation）OFD：開放式版式文檔（(OpenFixed-layoutDocument）URL：統(tǒng)一資源定位符/標(biāo)識(shí)（UniformResourceLocator）電子證照共享服務(wù)系統(tǒng)接入內(nèi)容包括但不限于：電子證照共享服務(wù)系統(tǒng)接入流程見圖1，包括：IP發(fā)證核驗(yàn)2DB11/T2290—2024圖1 電子照享務(wù)統(tǒng)入流采用接口對(duì)接方式，相關(guān)接口應(yīng)符合第6章接口要求。數(shù)據(jù)傳輸時(shí)應(yīng)采用數(shù)據(jù)加密技術(shù)，基于HTTPS協(xié)議保證傳輸通信鏈路的安全。3DB11/T2290—2024數(shù)據(jù)安全要求包括但不限于：會(huì)話安全要求包括但不限于：電子證照共享系統(tǒng)的接口包括但不限于：安全會(huì)話接口包括登錄接口、退出登錄接口和獲取當(dāng)前已登錄用戶信息接口，具體請(qǐng)求方法、URL地址、訪問(wèn)權(quán)限、請(qǐng)求參數(shù)、返回結(jié)果等接口描述，應(yīng)符合表1、表2、表3的相關(guān)要求，接口示例見附錄B。表1 登錄接口名稱login接口說(shuō)明通過(guò)用戶名和密碼進(jìn)行身份驗(yàn)證，驗(yàn)證成功后創(chuàng)建會(huì)話。所有管理操作均應(yīng)在有效的會(huì)話內(nèi)進(jìn)行。請(qǐng)求方法POSTURL地址https://{API_ROOT}/security/login請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明app_id是String分配給應(yīng)用程序的標(biāo)識(shí)app_secret是String分配給應(yīng)用程序的密碼account是String用戶賬戶名稱password是String用戶賬戶密碼org_code否String以指定的部門管理員身份登錄4DB11/T2290—2024表1 登接（）返回結(jié)果accessId是String登錄成功則返回安全標(biāo)識(shí)accesstoken是String登錄成功則返回安全會(huì)話訪問(wèn)令牌表2 出登接口方法名稱logout方法說(shuō)明注銷當(dāng)前會(huì)話請(qǐng)求方法POSTURL地址https://{API_ROOT}/security/logout訪問(wèn)主體已登錄用戶表3 獲取前登用信接口方法名稱get_current_user方法說(shuō)明獲取當(dāng)前已登錄用戶的信息請(qǐng)求方法GETURL地址https://{API_ROOT}/security/get_current_user訪問(wèn)主體已登錄用戶返回結(jié)果參數(shù)名必選類型范圍說(shuō)明data是JSON用戶信息電子證照目錄查詢接口的請(qǐng)求方法、URL地址、訪問(wèn)權(quán)限、請(qǐng)求參數(shù)、返回結(jié)果等接口描述應(yīng)符合表4的相關(guān)要求，接口示例見附錄C。表4 電子照錄詢方法名稱list方法說(shuō)明查詢電子證照目錄的元數(shù)據(jù)信息請(qǐng)求方法GETURL地址https://{API_ROOT}/license_item/list訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明page_index否Integer返回第幾頁(yè)數(shù)據(jù)，默認(rèn)值1page_size否Integer返回?cái)?shù)據(jù)的每頁(yè)大小，默認(rèn)值10，最大值150keyword否String查詢關(guān)鍵字（證照名稱，目錄編制部門）5DB11/T2290—2024表4 電證目查口（）請(qǐng)求參數(shù)status否LicenseItemStatus證照狀態(tài)（默認(rèn)查詢已發(fā)布，多個(gè)時(shí)中間以逗號(hào)[,]分割）is_open否Boolean開通狀態(tài)（默認(rèn)已開通）返回結(jié)果data是List<LicenseItem>電子證照目錄的元數(shù)據(jù)信息567表5 創(chuàng)建證據(jù)方法名稱create方法說(shuō)明生成電子證照版式文件請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/create訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明data_fields是JSON證照數(shù)據(jù)內(nèi)容operator是JSON制證操作人信息service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)license_group否String照面模版組別名稱seal_code是String印章編碼返回結(jié)果license_code是String證照唯一編碼auth_code是String電子證照用證碼表6 修改證據(jù)方法名稱update方法說(shuō)明修改電子證照制證數(shù)據(jù)請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/update訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_code是String證照唯一編碼data_fields是JSON證照數(shù)據(jù)內(nèi)容operator是JSON制證操作人信息6DB11/T2290—2024表6 修制數(shù)接續(xù)）請(qǐng)求參數(shù)service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)license_group否String照面模版組別名稱seal_code否String印章編碼返回結(jié)果返回公共參數(shù)表7 刪除證據(jù)方法名稱delete方法說(shuō)明刪除電子證照制證數(shù)據(jù)請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/delete訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_code是String證照唯一編碼id_code否String證照號(hào)碼operator是JSON制證操作人信息service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)返回結(jié)果返回公共參數(shù)URL、表910、表11的相。表8 簽發(fā)照方法名稱sign方法說(shuō)明簽發(fā)電子證照請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/sign訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_code是String證照唯一編碼id_code是String證照號(hào)碼7DB11/T2290—2024表8 簽證接（）請(qǐng)求參數(shù)service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String業(yè)務(wù)流水號(hào)operator是JSON簽發(fā)操作人信息返回結(jié)果返回公共參數(shù)表9 變更照方法名稱change方法說(shuō)明變更電子證照請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/change訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_code是String原證照唯一編碼id_code否String原證照號(hào)碼data_fields是JSON變更后的證照數(shù)據(jù)內(nèi)容，用于簽發(fā)新證service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)operator是JSON變更操作人信息返回結(jié)果license_code是String證照唯一編碼auth_code是String電子證照用證碼表10 廢止照方法名稱abolish方法說(shuō)明廢止電子證照請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/abolish訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_code是String證照唯一編碼id_code否String證照號(hào)碼service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱8DB11/T2290—2024表10 廢證接（）請(qǐng)求參數(shù)biz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)operator是JSON廢止操作人信息返回結(jié)果返回公共參數(shù)表11 批量作照方法名稱create方法說(shuō)明批量制證接口請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/{item_code}/batch_create訪問(wèn)權(quán)限已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明licenses是List<JSON>制證數(shù)據(jù)請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String申辦流水號(hào)operator是JSON當(dāng)前用戶信息（業(yè)務(wù)人員信息）返回結(jié)果license_codes是List<Object>證照唯一編碼URL12131416。表12 統(tǒng)一份證證方法名稱psn_holder方法說(shuō)明列舉一個(gè)持證人所有的電子證照清單，同時(shí)對(duì)結(jié)果清單每一項(xiàng)生成用證碼。該接口主要用于統(tǒng)一身份認(rèn)證系統(tǒng)使用請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/psn_holder訪問(wèn)權(quán)限所有已登錄用戶，并已通過(guò)實(shí)名賬號(hào)系統(tǒng)獲取訪問(wèn)令牌請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明page_index否Integer返回第幾頁(yè)數(shù)據(jù)，默認(rèn)值為1page_size否Integer返回?cái)?shù)據(jù)的每頁(yè)大小，默認(rèn)值為10，最大值為150credential是String實(shí)名登錄憑據(jù)token，持證主體代碼返回結(jié)果data否List<JSON>電子證照列表auth_codes否List<String>用證碼列表9DB11/T2290—2024表13 用證提證數(shù)接口方法名稱get_license方法說(shuō)明根據(jù)用證碼提取電子證照的結(jié)構(gòu)化數(shù)據(jù)請(qǐng)求方法GETURL地址https://{API_ROOT}/license/get_license_qr訪問(wèn)權(quán)限所有已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明auth_code是String電子證照用證碼service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String業(yè)務(wù)流水號(hào)operator是Operator發(fā)起此次用證的業(yè)務(wù)人員信息。用于記錄審計(jì)日志返回結(jié)果data是JSON電子證照表14 用證換訪令接口方法名稱get_token_qr方法說(shuō)明根據(jù)用證碼獲取電子證照的訪問(wèn)令牌請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/get_token_qr訪問(wèn)權(quán)限所有合法的第三方程序請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明auth_code是String電子證照用證碼operator是Operator當(dāng)前操作人信息service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱biz_num否String業(yè)務(wù)流水號(hào)返回結(jié)果expires_in是String如果調(diào)用成功，返回訪問(wèn)令牌有效期。（yy-mm-ddhh:mm:ss）license_access_token是String如果調(diào)用成功，返回訪問(wèn)令牌10DB11/T2290—2024表15 用證歸電文接口方法名稱archive_qr方法說(shuō)明根據(jù)用證碼獲取用于歸檔的電子證照文件請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/archive_qr訪問(wèn)權(quán)限所有已注冊(cè)用戶，并已通過(guò)實(shí)名賬號(hào)系統(tǒng)獲取訪問(wèn)令牌請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明auth_code是String電子證照用證碼file_type否String電子文件類型，默認(rèn)為OFDservice_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱service_item_org是String事項(xiàng)所屬單位operator是Operator發(fā)起此次用證的業(yè)務(wù)人員信息。用于記錄審計(jì)日志返回結(jié)果file_name是StringOFD文件名file_data是StringOFD文件內(nèi)容數(shù)據(jù)（base64編碼）表16 查看子照動(dòng)頁(yè)接口方法名稱view_mobile方法說(shuō)明根據(jù)用證碼獲取電子證照移動(dòng)端頁(yè)面請(qǐng)求方法GETURL地址https://{WEB_ROOT}/license/view_mobile請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_access_token是String電子證照訪問(wèn)令牌返回結(jié)果H5頁(yè)面Html電子證照移動(dòng)端展示頁(yè)面URL171819、表20G。11DB11/T2290—2024表17 依職查用接口方法名稱auth方法說(shuō)明依職能查驗(yàn)用證。根據(jù)事項(xiàng)編碼以及辦事人身份證件號(hào)，列舉出該辦事人在該事項(xiàng)所需要用的證照，同時(shí)對(duì)結(jié)果清單每一項(xiàng)生成用證碼。該接口主要在部門業(yè)務(wù)審批辦理系統(tǒng)使用請(qǐng)求方法POSTURL地址https://{API_ROOT}/license/auth訪問(wèn)權(quán)限所有已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明page_index否Integer返回第幾頁(yè)數(shù)據(jù)，默認(rèn)值1page_size否Integer返回?cái)?shù)據(jù)的每頁(yè)大小，默認(rèn)值10，最大值150service_item_code是String事項(xiàng)編碼service_item_name是String事項(xiàng)名稱show_sensitive_data否String顯示敏感數(shù)據(jù)顯示為true不顯示為falsebiz_num否String對(duì)應(yīng)辦件的業(yè)務(wù)流水號(hào)operator是JSON發(fā)起此次用證的業(yè)務(wù)人員信息，用于記錄審計(jì)日志identity_number是String證件號(hào)碼，多個(gè)時(shí)用逗號(hào)（,）分隔返回結(jié)果total_count否Integer記錄數(shù)data否List<JSON>電子證照列表auth_codes否List<String>用證碼列表表18 獲取照問(wèn)牌方法名稱token方法說(shuō)明根據(jù)電子證照用證碼（auth_code）獲取電子證照訪問(wèn)令牌（license_access_token）請(qǐng)求方法GETURL地址https://{API_ROOT}/license/token訪問(wèn)權(quán)限所有已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明auth_code是String電子證照用證碼返回結(jié)果expires_in否String如果調(diào)用成功，返回訪問(wèn)令牌有效期。格式為yyyy-MM-ddHH:mm:ss.ffflicense_access_token否String如果調(diào)用成功，返回電子證照訪問(wèn)令牌12DB11/T2290—2024表19 提取照據(jù)方法名稱get_license方法說(shuō)明根據(jù)用證碼提取一個(gè)電子證照的信息請(qǐng)求方法GETURL地址https://{API_ROOT}/license/get_license訪問(wèn)權(quán)限所有已登錄用戶請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明auth_code是String電子證照用證碼返回結(jié)果data否JSON電子證照結(jié)構(gòu)化數(shù)據(jù)表20 查看子照面方法名稱view_license方法說(shuō)明顯示單個(gè)電子證照的詳情頁(yè)面請(qǐng)求方法GETURL地址https://{WEB_ROOT}/license/view_license請(qǐng)求參數(shù)參數(shù)名必選類型范圍說(shuō)明license_access_token是String電子證照訪問(wèn)令牌返回結(jié)果H5頁(yè)面Html電子證照展示頁(yè)面制證簽發(fā)接口調(diào)用流程包括：用證接口調(diào)用流程描述如下：（13DB11/T2290—2024變更接口調(diào)用流程描述如下：廢止接口調(diào)用流程描述如下：14DB11/T2290—2024附錄A（資料性）電子證照共享服務(wù)系統(tǒng)接入申請(qǐng)A.1 電子證照共享服務(wù)系統(tǒng)接入申請(qǐng)表見表A.1。表A.1電子證照共享服務(wù)系統(tǒng)接入申請(qǐng)表單位名稱單位統(tǒng)一社會(huì)信用代碼聯(lián)系人姓名上級(jí)主管部門聯(lián)系人電話聯(lián)系人電子郵箱接入內(nèi)容□安全會(huì)話 電子證照目錄查詢 □電子證照制證□電子證照操作發(fā)布 電子證照持證主體授權(quán)服務(wù) □電子證照依職能查驗(yàn)用證對(duì)應(yīng)證照序號(hào)證照名稱業(yè)務(wù)系統(tǒng)印章信息部門(蓋章)：時(shí)間：年 月 日15DB11/T2290—2024附錄B（資料性）安全會(huì)話接口調(diào)用示例查詢登錄接口調(diào)用示例，以JSON格式描述舉例，詳見表B.1。表B.1登錄接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/security/loginContent-Type:application/JSON{"app_id":"APP_KEY","app_secret":"APP_SECRET","account":"test_bj_wht","password":"abc123"}返回示例{"ack_code":"SUCCESS","errors":[],"access_token":"ACCESS_TOKEN"}退出登錄接口調(diào)用示例，以JSON格式描述舉例，詳見表B.2。表B.2退出登錄接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/security/logout?access_token=ACCESS_TOKENContent-Type:application/JSON{}返回示例{"ack_code":"SUCCESS","errors":[]}獲取當(dāng)前已登錄用戶信息接口調(diào)用示例，以JSON格式描述舉例，詳見表B.3。16DB11/T2290—2024表B.3獲取當(dāng)前已登錄用戶信息接口調(diào)用示例請(qǐng)求示例GEThttps://{API_ROOT}/security/get_current_user?access_token=ACCESS_TOKEN返回示例{"ack_code":"SUCCESS","errors":[],"data":{"account":"bj_admin","name":"北京市管理員","identity_num":"110105************","division":"北京市","division_code":"110105","service_org":"123456789","creator":"admin","creation_time":"2020-5-22","last_modificator":"admin","last_modification_time":"2020-5-22"}}17DB11/T2290—2024附錄C（資料性）電子證照目錄查詢接口調(diào)用示例C.1 電子證照目錄查詢接口調(diào)用示例，以JSON格式描述舉例，詳見表C.1。表C.1電子證照目錄查詢接口調(diào)用示例請(qǐng)求示例GET https://{API_ROOT}/license_item/list?access_token=ACCESS_TOKEN&status=PUBLI SH&is_open=true{"ack_code":"SUCCESS","response_id":"88429079-bbd6-4a65-a6c5-cad9f806814e","timestamp":"2020-06-2715:25:02.123","errors":[],返回示例"data":[{"license_item_code"："100185101",……}]}18DB11/T2290—2024附錄D（資料性）電子證照制證接口調(diào)用示例創(chuàng)建制證數(shù)據(jù)接口調(diào)用示例，以JSON格式描述舉例，詳見表D.1。表D.1創(chuàng)建制證數(shù)據(jù)接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/create?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code":"事項(xiàng)編碼","service_item_name":"事項(xiàng)名稱","biz_num":"業(yè)務(wù)流水號(hào)","operator":{"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝陽(yáng)區(qū)朝陽(yáng)路111號(hào)","IDENTITY_NUMBER":"110105************",……}}19DB11/T2290—2024表D.1創(chuàng)建制證數(shù)據(jù)接口調(diào)用示例（續(xù)）返回示例{"ack_code":"SUCCESS","errors":[],"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a98-bb71-bad846434f8d"，"data":{"license_code":"11000016D000020"，"auth_code":"11000******0"}}修改制證數(shù)據(jù)接口調(diào)用示例，以JSON格式描述舉例，詳見表D.2。表D.2修改制證數(shù)據(jù)接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/update?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code"service_item_name"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝陽(yáng)區(qū)朝陽(yáng)路111號(hào)","IDENTITY_NUMBER":"110105************",……}}20DB11/T2290—2024表D.2修改制證數(shù)據(jù)接口調(diào)用示例（續(xù)）返回示例{"ack_code":"SUCCESS","errors":[],"sign":null,"sign_method":null,"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a98-bb71-bad846434f8d"}刪除制證數(shù)據(jù)接口調(diào)用示例，以JSON格式描述舉例，詳見表D.3。表D.3刪除制證數(shù)據(jù)接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/delete？access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code"service_item_name"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}}返回示例{"ack_code":"SUCCESS","errors":[],"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a38-bb71-bad846434f8d"}21DB11/T2290—2024附錄E（資料性）電子證照操作發(fā)布接口調(diào)用示例簽發(fā)證照接口調(diào)用示例，以JSON格式描述舉例，詳見表E.1。表E.1簽發(fā)證照接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/sign?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code"service_item_name"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}}返回示例{"ack_code":"SUCCESS","errors":[],"sign":null,"sign_method":null,"timestamp":null,"correlation_id":null,"response_id":"dfc1be0d-ca4f-4a98-bb71-bad846434f8d"}22DB11/T2290—2024變更證照接口調(diào)用示例，以JSON格式描述舉例，詳見表E.2。表E.2變更證照接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/change?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code"service_item_name"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝陽(yáng)區(qū)朝陽(yáng)路111號(hào)","IDENTITY_NUMBER":"110105************",……}}返回示例{"ack_code":"SUCCESS","errors":[],"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a38-bb71-bad846434f8d","data":{"license_code":"11000016D000020"，"auth_code":"11000******0"}}23DB11/T2290—2024廢止一張證照接口調(diào)用示例，以JSON格式描述舉例，詳見表E.3。表E.3廢止證照接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/006939684110000/abolish?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"license_code":"11000015D00032V","service_item_code":"事項(xiàng)編碼","service_item_name":"事項(xiàng)名稱","biz_num":"業(yè)務(wù)流水號(hào)","operator":{"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"朝陽(yáng)區(qū)","division_code":"110105"}}}返回示例{"ack_code":"SUCCESS","errors":[],"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a38-bb71-bad846434f8d"}批量制作證照接口調(diào)用示例，以JSON格式描述舉例，詳見表E.4。24DB11/T2290—2024表E.4批量制作證照接口調(diào)用示例POSThttps://{API_ROOT}/license/305018201/batch_create?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"licenses":[{"data_fields":{"FZRQ":"2020-02-14","POXM":"bbb","FZJGSSXZQHDM":"110103","ZP":"","POGJ":"中國(guó)","CZRCSRQ":"1992-02-14","CZRXB":"男","JHZZH":"J110103-2020-000002",請(qǐng)求示例"CYRSFZJLX":"10","FZJGMC":"北京市XX局","HYDJY":"張XX","YXQJSRQ":"","CZRGJ":"中國(guó)","CYRSFZJHM":"110103************","POSFZJLX":"10","POCSRQ":"1992-01-01","POXB":"女","CZR":"aaa","FZJGZZJGDM":"1100A1000000","BZ":"","ZZMC":"XX證","POSFZJH":"110102************"}"license_group":"1"},{25DB11/T2290—2024表E.4批量制作證照接口調(diào)用示例（續(xù)）"data_fields":{"FZRQ":"2020-02-14","POXM":"bbb","FZJGSSXZQHDM":"110103","ZP":"","POGJ":"中國(guó)","CZRCSRQ":"1992-01-01","CZRXB":"男","JHZZH":"J110103-2020-000002","CYRSFZJLX":"10","FZJGMC":"北京市XX局","HYDJY":"張XX","YXQJSRQ":"","CZRGJ":"中國(guó)","CYRSFZJHM":"110103************","POSFZJLX":"10","POCSRQ":"1992-01-01","POXB":"女","CZR":"aaa","FZJGZZJGDM":"1100A1000000",請(qǐng)求示例"BZ":"","ZZMC":"XX證","POSFZJH":"110102************"},"license_group":"1"}],"operator":{"division_code":"110000","service_org":"北京市XX局","division":"北京市","identity_num":"","account":"110000_zhangbin","role":"內(nèi)地居民婚姻登記角色","name":"張XX"},"service_item_code":"110103MZ001",110"service_item_name":"婚姻登記","biz_num":"20200721123"}}26DB11/T2290—2024表E.4批量制作證照接口調(diào)用示例（續(xù)）返回示例{"ack_code":"SUCCESS","errors":[],"sign":null,"sign_method":null,"timestamp":null,"correlation_id":"2b7bcfde-f621-4945-b282-f49873311436","response_id":"bc90eb57-422c-4c0e-a941-36c8e9ff063e","data":{"license_codes":["11000020200000HS2P","11000020200000HU1N"]}}27DB11/T2290—2024附錄F（資料性）電子證照持證主體用證服務(wù)接口調(diào)用示例統(tǒng)一身份認(rèn)證用證接口調(diào)用示例，以JSON格式描述舉例，詳見表F.1。表F.1電子證照持證主體授權(quán)服務(wù)接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/webpage?access_token=ACCESS_TOKENContent-Type:application/JSON{"credential":"MCK0102************","token_id":"************"，"random":"************"}返回示例{"ack_code":"SUCCESS","errors":[],"total_count":1,"auth_codes":["aaa","bbb"],"data":[{"data_fields":{"license_code":"010119432342342","name":"身份證","issue_org_name":"市XX局","issue_org_code":"11************4550",//取值為18位"issue_date":"2020-12-12","expiry_date":"2020-12-12","version":"1","creator":"test","creation_time":"2020-12-1","last_modificator":"test","last_modification_time":"2020-12-2"}}]}用證碼提取證照數(shù)據(jù)接口調(diào)用示例，以JSON格式描述舉例，詳見表F.2。28DB11/T2290—2024表F.2用證碼提取證照數(shù)據(jù)接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/get_license_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code":"AUTH_CODE","service_item_name":"申辦事項(xiàng)","service_item_code":"1234567890","biz_num":"10021800000693979911307100001","operator":{"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"北京市","division_code":"110105"}}}返回示例{"ack_code":"SUCCESS","errors":[],"data":{"data_fields":{"license_code":"010119432342342","name":"身份證","issue_org_name":"市XX局","issue_org_code":"11************4550",//取值為18位"issue_date":"2020-12-12","expiry_date":"2020-12-12","version":"1","creator":"test","creation_time":"2020-12-1","last_modificator":"test","last_modification_time":"2020-12-2"}}}用證碼換取訪問(wèn)令牌接口調(diào)用示例，以JSON格式描述舉例，詳見表F.3。29DB11/T2290—2024表F.3用證碼換取訪問(wèn)令牌接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/get_token_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code”:”1235815”,"service_item_code":"事項(xiàng)編碼","service_item_name":"事項(xiàng)名稱",“operator”:{…}}返回示例"errcode":0,"errmsg":””,“data”:{"expires_in":"2020-12-1200:00:00","license_access_token":"dFVzVNBfWiHMAnW6ArZI"}用證碼歸檔電子文件接口調(diào)用示例，以JSON格式描述舉例，詳見表F.4。30DB11/T2290—2024表F.4用證碼歸檔電子文件接口調(diào)用示例請(qǐng)求示例POSThttps://{API_ROOT}/license/archive_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code":"AUTH_CODE","service_item_name":"申辦事項(xiàng)","service_item_code":"1234567890","biz_num":"10021800000693979911307100001","operator":{"account":"bj_mzj","name":"張XX","identity_num":"110105************","role":"市XX局XX處室科員","service_org":"市XX局","division":"北京市","division_code":"110105"}"terminal_info":"","timestamp":"2020-10-1010:10:10","request_id":"b2629b80-a96f-469b-87f7-0496bee4f958"}}返回示例{"ack_code":"SUCCESS","errors":[],"data":{"file_name":"11000016D000020.ofd","file_data":"BDAAUDBAQE/Z",}}查看電子證照移動(dòng)端