DB11T 2290-2024 电子证照共享服务系统接入技术要求

ICS35.240.01CCSL70

DB11北 京 市 地 方 标 准DB11/T2290—2024电子证照共享服务系统接入技术要求Technicalrequirmentsforshareserviceelectroniccertificatesystemaccess2024-06-28发布 2024-10-01实施北京市市场监督管理局 发布DB11/T2290—2024目 次前言 III1范引文件 1语定义 1略语 2子照享务接入 2接内容 2接流程 2接方式 3接安全 3子照享务接口4接内容 4安会接口 4电证目查5电证制接口 6电证操发7电证持主权服接口 9电证依能用证11接调流程 13附录A（料） 电证照享务统入15A.1 电证共服统接申15附录B（料） 安会话口用16登接调示例 16退登接调16获当已录信息口用16附录C（料） 电证照录询口用18C.1 电证目查口调示例 18附录D（料） 电证照证口用19创制数接用示例 19修制数接用示例 20删制数接用示例 21附录E（料） 电证照作布口用22签证接调22变一证接用示例 23废一证接用示例 24IDB11/T2290—2024批制证接用示例 24附录F（料） 电证照证体证务口调示例 28统身认用口调示例 28用码取照接口用28用码取问接口用29用码档子接口用30查电证移页面口用31附录G（料） 电证照证务口用32依能验证调用32获证访令口调示例 33提证数接用示例 34查电证页口调示例 34参考献 35IIDB11/T2290—2024前 言本文按GB/T1.1—2020《准工导则 第部分标化件结和起规》起草。本文件由北京市经济和信息化局提出。本文件由北京市政务服务和数据管理局归口并组织实施。本文件起草单位：北京市大数据中心、北京数字认证股份有限公司、中国电子技术标准化研究院。本文件主要起草人：朱芳、郭家义、林峰璞、彭雪海、张琳、石志国、刘旭、陈桂红、赵琰昉、柳笛、朱蓉华、牟大伟、梁玉晨、陈亚军、刘文、李佳妮、徐文龙、舒峥。IIIDB11/T2290—2024电子证照共享服务系统接入技术要求范围本文件规定了电子证照共享服务系统的接入内容、接入流程、接入方式、接入安全以及接口要求。本文件适用于政务部门存在用证需求的业务系统（以下简称业务系统）与电子证照共享服务系统的对接工作。（GB/T36901 GB/T36906 DB11/T1901 GB/T36901、GB/T36906、DB11/T1901界定的以及下列术语和定义适用于本文件。证照certificate由机关、团体、企事业单位颁发的，能够证明资格或权利等的凭证类文件。：GB/T36901-2018，3.1]certificatecatalog依据元数据规范对证照提取特征，并按照一定的分类方法进行排序和编码形成的一组信息。[来源：GB/T36901-2018，3.2]电子证照electroniccertificate按规范形式表达或承载证照信息的电子文件，包含证照模板、证照数据和签章/签名信息。[来源：GB/T36901-2018，3.3]电子证照共享服务系统electroniccertificatesystemforshareservice为政务部门提供电子证照共享服务的系统。事项编码itemcode给政务部门存在用证需求的事项赋予的代码。事项名称itemname对政务部门存在用证需求的事项进行规范统一的命名。1DB11/T2290—2024缩略语下列缩略语适用于本文件。API：应用程序接口（ApplicationProgrammingInterface）HTTPS：安全的超文本传输协议（HypertextTransferProtocolSecure）JSON：JS对象简谱（JavaScriptObjectNotation）OFD：开放式版式文档（(OpenFixed-layoutDocument）URL：统一资源定位符/标识（UniformResourceLocator）电子证照共享服务系统接入内容包括但不限于：电子证照共享服务系统接入流程见图1，包括：IP发证核验2DB11/T2290—2024图1 电子照享务统入流采用接口对接方式，相关接口应符合第6章接口要求。数据传输时应采用数据加密技术，基于HTTPS协议保证传输通信链路的安全。3DB11/T2290—2024数据安全要求包括但不限于：会话安全要求包括但不限于：电子证照共享系统的接口包括但不限于：安全会话接口包括登录接口、退出登录接口和获取当前已登录用户信息接口，具体请求方法、URL地址、访问权限、请求参数、返回结果等接口描述，应符合表1、表2、表3的相关要求，接口示例见附录B。表1 登录接口名称login接口说明通过用户名和密码进行身份验证，验证成功后创建会话。所有管理操作均应在有效的会话内进行。请求方法POSTURL地址https://{API_ROOT}/security/login请求参数参数名必选类型范围说明app_id是String分配给应用程序的标识app_secret是String分配给应用程序的密码account是String用户账户名称password是String用户账户密码org_code否String以指定的部门管理员身份登录4DB11/T2290—2024表1 登接（）返回结果accessId是String登录成功则返回安全标识accesstoken是String登录成功则返回安全会话访问令牌表2 出登接口方法名称logout方法说明注销当前会话请求方法POSTURL地址https://{API_ROOT}/security/logout访问主体已登录用户表3 获取前登用信接口方法名称get_current_user方法说明获取当前已登录用户的信息请求方法GETURL地址https://{API_ROOT}/security/get_current_user访问主体已登录用户返回结果参数名必选类型范围说明data是JSON用户信息电子证照目录查询接口的请求方法、URL地址、访问权限、请求参数、返回结果等接口描述应符合表4的相关要求，接口示例见附录C。表4 电子照录询方法名称list方法说明查询电子证照目录的元数据信息请求方法GETURL地址https://{API_ROOT}/license_item/list访问权限已登录用户请求参数参数名必选类型范围说明page_index否Integer返回第几页数据，默认值1page_size否Integer返回数据的每页大小，默认值10，最大值150keyword否String查询关键字（证照名称，目录编制部门）5DB11/T2290—2024表4 电证目查口（）请求参数status否LicenseItemStatus证照状态（默认查询已发布，多个时中间以逗号[,]分割）is_open否Boolean开通状态（默认已开通）返回结果data是List<LicenseItem>电子证照目录的元数据信息567表5 创建证据方法名称create方法说明生成电子证照版式文件请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/create访问权限已登录用户请求参数参数名必选类型范围说明data_fields是JSON证照数据内容operator是JSON制证操作人信息service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号license_group否String照面模版组别名称seal_code是String印章编码返回结果license_code是String证照唯一编码auth_code是String电子证照用证码表6 修改证据方法名称update方法说明修改电子证照制证数据请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/update访问权限已登录用户请求参数参数名必选类型范围说明license_code是String证照唯一编码data_fields是JSON证照数据内容operator是JSON制证操作人信息6DB11/T2290—2024表6 修制数接续）请求参数service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号license_group否String照面模版组别名称seal_code否String印章编码返回结果返回公共参数表7 删除证据方法名称delete方法说明删除电子证照制证数据请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/delete访问权限已登录用户请求参数参数名必选类型范围说明license_code是String证照唯一编码id_code否String证照号码operator是JSON制证操作人信息service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号返回结果返回公共参数URL、表910、表11的相。表8 签发照方法名称sign方法说明签发电子证照请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/sign访问权限已登录用户请求参数参数名必选类型范围说明license_code是String证照唯一编码id_code是String证照号码7DB11/T2290—2024表8 签证接（）请求参数service_item_code是String事项编码service_item_name是String事项名称biz_num否String业务流水号operator是JSON签发操作人信息返回结果返回公共参数表9 变更照方法名称change方法说明变更电子证照请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/change访问权限已登录用户请求参数参数名必选类型范围说明license_code是String原证照唯一编码id_code否String原证照号码data_fields是JSON变更后的证照数据内容，用于签发新证service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是JSON变更操作人信息返回结果license_code是String证照唯一编码auth_code是String电子证照用证码表10 废止照方法名称abolish方法说明废止电子证照请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/abolish访问权限已登录用户请求参数参数名必选类型范围说明license_code是String证照唯一编码id_code否String证照号码service_item_code是String事项编码service_item_name是String事项名称8DB11/T2290—2024表10 废证接（）请求参数biz_num否String对应办件的业务流水号operator是JSON废止操作人信息返回结果返回公共参数表11 批量作照方法名称create方法说明批量制证接口请求方法POSTURL地址https://{API_ROOT}/license/{item_code}/batch_create访问权限已登录用户请求参数参数名必选类型范围说明licenses是List<JSON>制证数据请求参数参数名必选类型范围说明service_item_code是String事项编码service_item_name是String事项名称biz_num否String申办流水号operator是JSON当前用户信息（业务人员信息）返回结果license_codes是List<Object>证照唯一编码URL12131416。表12 统一份证证方法名称psn_holder方法说明列举一个持证人所有的电子证照清单，同时对结果清单每一项生成用证码。该接口主要用于统一身份认证系统使用请求方法POSTURL地址https://{API_ROOT}/license/psn_holder访问权限所有已登录用户，并已通过实名账号系统获取访问令牌请求参数参数名必选类型范围说明page_index否Integer返回第几页数据，默认值为1page_size否Integer返回数据的每页大小，默认值为10，最大值为150credential是String实名登录凭据token，持证主体代码返回结果data否List<JSON>电子证照列表auth_codes否List<String>用证码列表9DB11/T2290—2024表13 用证提证数接口方法名称get_license方法说明根据用证码提取电子证照的结构化数据请求方法GETURL地址https://{API_ROOT}/license/get_license_qr访问权限所有已登录用户请求参数参数名必选类型范围说明auth_code是String电子证照用证码service_item_code是String事项编码service_item_name是String事项名称biz_num否String业务流水号operator是Operator发起此次用证的业务人员信息。用于记录审计日志返回结果data是JSON电子证照表14 用证换访令接口方法名称get_token_qr方法说明根据用证码获取电子证照的访问令牌请求方法POSTURL地址https://{API_ROOT}/license/get_token_qr访问权限所有合法的第三方程序请求参数参数名必选类型范围说明auth_code是String电子证照用证码operator是Operator当前操作人信息service_item_code是String事项编码service_item_name是String事项名称biz_num否String业务流水号返回结果expires_in是String如果调用成功，返回访问令牌有效期。（yy-mm-ddhh:mm:ss）license_access_token是String如果调用成功，返回访问令牌10DB11/T2290—2024表15 用证归电文接口方法名称archive_qr方法说明根据用证码获取用于归档的电子证照文件请求方法POSTURL地址https://{API_ROOT}/license/archive_qr访问权限所有已注册用户，并已通过实名账号系统获取访问令牌请求参数参数名必选类型范围说明auth_code是String电子证照用证码file_type否String电子文件类型，默认为OFDservice_item_code是String事项编码service_item_name是String事项名称service_item_org是String事项所属单位operator是Operator发起此次用证的业务人员信息。用于记录审计日志返回结果file_name是StringOFD文件名file_data是StringOFD文件内容数据（base64编码）表16 查看子照动页接口方法名称view_mobile方法说明根据用证码获取电子证照移动端页面请求方法GETURL地址https://{WEB_ROOT}/license/view_mobile请求参数参数名必选类型范围说明license_access_token是String电子证照访问令牌返回结果H5页面Html电子证照移动端展示页面URL171819、表20G。11DB11/T2290—2024表17 依职查用接口方法名称auth方法说明依职能查验用证。根据事项编码以及办事人身份证件号，列举出该办事人在该事项所需要用的证照，同时对结果清单每一项生成用证码。该接口主要在部门业务审批办理系统使用请求方法POSTURL地址https://{API_ROOT}/license/auth访问权限所有已登录用户请求参数参数名必选类型范围说明page_index否Integer返回第几页数据，默认值1page_size否Integer返回数据的每页大小，默认值10，最大值150service_item_code是String事项编码service_item_name是String事项名称show_sensitive_data否String显示敏感数据显示为true不显示为falsebiz_num否String对应办件的业务流水号operator是JSON发起此次用证的业务人员信息，用于记录审计日志identity_number是String证件号码，多个时用逗号（,）分隔返回结果total_count否Integer记录数data否List<JSON>电子证照列表auth_codes否List<String>用证码列表表18 获取照问牌方法名称token方法说明根据电子证照用证码（auth_code）获取电子证照访问令牌（license_access_token）请求方法GETURL地址https://{API_ROOT}/license/token访问权限所有已登录用户请求参数参数名必选类型范围说明auth_code是String电子证照用证码返回结果expires_in否String如果调用成功，返回访问令牌有效期。格式为yyyy-MM-ddHH:mm:ss.ffflicense_access_token否String如果调用成功，返回电子证照访问令牌12DB11/T2290—2024表19 提取照据方法名称get_license方法说明根据用证码提取一个电子证照的信息请求方法GETURL地址https://{API_ROOT}/license/get_license访问权限所有已登录用户请求参数参数名必选类型范围说明auth_code是String电子证照用证码返回结果data否JSON电子证照结构化数据表20 查看子照面方法名称view_license方法说明显示单个电子证照的详情页面请求方法GETURL地址https://{WEB_ROOT}/license/view_license请求参数参数名必选类型范围说明license_access_token是String电子证照访问令牌返回结果H5页面Html电子证照展示页面制证签发接口调用流程包括：用证接口调用流程描述如下：（13DB11/T2290—2024变更接口调用流程描述如下：废止接口调用流程描述如下：14DB11/T2290—2024附录A（资料性）电子证照共享服务系统接入申请A.1 电子证照共享服务系统接入申请表见表A.1。表A.1电子证照共享服务系统接入申请表单位名称单位统一社会信用代码联系人姓名上级主管部门联系人电话联系人电子邮箱接入内容□安全会话 电子证照目录查询 □电子证照制证□电子证照操作发布 电子证照持证主体授权服务 □电子证照依职能查验用证对应证照序号证照名称业务系统印章信息部门(盖章)：时间：年 月 日15DB11/T2290—2024附录B（资料性）安全会话接口调用示例查询登录接口调用示例，以JSON格式描述举例，详见表B.1。表B.1登录接口调用示例请求示例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"}退出登录接口调用示例，以JSON格式描述举例，详见表B.2。表B.2退出登录接口调用示例请求示例POSThttps://{API_ROOT}/security/logout?access_token=ACCESS_TOKENContent-Type:application/JSON{}返回示例{"ack_code":"SUCCESS","errors":[]}获取当前已登录用户信息接口调用示例，以JSON格式描述举例，详见表B.3。16DB11/T2290—2024表B.3获取当前已登录用户信息接口调用示例请求示例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（资料性）电子证照目录查询接口调用示例C.1 电子证照目录查询接口调用示例，以JSON格式描述举例，详见表C.1。表C.1电子证照目录查询接口调用示例请求示例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（资料性）电子证照制证接口调用示例创建制证数据接口调用示例，以JSON格式描述举例，详见表D.1。表D.1创建制证数据接口调用示例请求示例POSThttps://{API_ROOT}/license/006939684110000/create?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","operator":{"account":"bj_mzj","name":"张XX","identity_num":"110105************","role":"市XX局XX处室科员","service_org":"市XX局","division":"朝阳区","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","IDENTITY_NUMBER":"110105************",……}}19DB11/T2290—2024表D.1创建制证数据接口调用示例（续）返回示例{"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"}}修改制证数据接口调用示例，以JSON格式描述举例，详见表D.2。表D.2修改制证数据接口调用示例请求示例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":"朝阳区","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","IDENTITY_NUMBER":"110105************",……}}20DB11/T2290—2024表D.2修改制证数据接口调用示例（续）返回示例{"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"}删除制证数据接口调用示例，以JSON格式描述举例，详见表D.3。表D.3删除制证数据接口调用示例请求示例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":"朝阳区","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（资料性）电子证照操作发布接口调用示例签发证照接口调用示例，以JSON格式描述举例，详见表E.1。表E.1签发证照接口调用示例请求示例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":"朝阳区","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变更证照接口调用示例，以JSON格式描述举例，详见表E.2。表E.2变更证照接口调用示例请求示例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":"朝阳区","division_code":"110105"}}"data_fields":{"BIRTHPLACE":"北京","PERSON_NAME":"李XX","BIRTHDAY":"1992-02-14","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","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废止一张证照接口调用示例，以JSON格式描述举例，详见表E.3。表E.3废止证照接口调用示例请求示例POSThttps://{API_ROOT}/license/006939684110000/abolish?access_token=ACCESS_TOKENContent-Type:application/JSON{"data":{"license_code":"11000015D00032V","service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","operator":{"account":"bj_mzj","name":"张XX","identity_num":"110105************","role":"市XX局XX处室科员","service_org":"市XX局","division":"朝阳区","division_code":"110105"}}}返回示例{"ack_code":"SUCCESS","errors":[],"timestamp":"2020-06-2310:15:13.123","correlation_id":null,"response_id":"dfc1be0d-ca4f-4a38-bb71-bad846434f8d"}批量制作证照接口调用示例，以JSON格式描述举例，详见表E.4。24DB11/T2290—2024表E.4批量制作证照接口调用示例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":"中国","CZRCSRQ":"1992-02-14","CZRXB":"男","JHZZH":"J110103-2020-000002",请求示例"CYRSFZJLX":"10","FZJGMC":"北京市XX局","HYDJY":"张XX","YXQJSRQ":"","CZRGJ":"中国","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批量制作证照接口调用示例（续）"data_fields":{"FZRQ":"2020-02-14","POXM":"bbb","FZJGSSXZQHDM":"110103","ZP":"","POGJ":"中国","CZRCSRQ":"1992-01-01","CZRXB":"男","JHZZH":"J110103-2020-000002","CYRSFZJLX":"10","FZJGMC":"北京市XX局","HYDJY":"张XX","YXQJSRQ":"","CZRGJ":"中国","CYRSFZJHM":"110103************","POSFZJLX":"10","POCSRQ":"1992-01-01","POXB":"女","CZR":"aaa","FZJGZZJGDM":"1100A1000000",请求示例"BZ":"","ZZMC":"XX证","POSFZJH":"110102************"},"license_group":"1"}],"operator":{"division_code":"110000","service_org":"北京市XX局","division":"北京市","identity_num":"","account":"110000_zhangbin","role":"内地居民婚姻登记角色","name":"张XX"},"service_item_code":"110103MZ001",110"service_item_name":"婚姻登记","biz_num":"20200721123"}}26DB11/T2290—2024表E.4批量制作证照接口调用示例（续）返回示例{"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（资料性）电子证照持证主体用证服务接口调用示例统一身份认证用证接口调用示例，以JSON格式描述举例，详见表F.1。表F.1电子证照持证主体授权服务接口调用示例请求示例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"}}]}用证码提取证照数据接口调用示例，以JSON格式描述举例，详见表F.2。28DB11/T2290—2024表F.2用证码提取证照数据接口调用示例请求示例POSThttps://{API_ROOT}/license/get_license_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code":"AUTH_CODE","service_item_name":"申办事项","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"}}}用证码换取访问令牌接口调用示例，以JSON格式描述举例，详见表F.3。29DB11/T2290—2024表F.3用证码换取访问令牌接口调用示例请求示例POSThttps://{API_ROOT}/license/get_token_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code”:”1235815”,"service_item_code":"事项编码","service_item_name":"事项名称",“operator”:{…}}返回示例"errcode":0,"errmsg":””,“data”:{"expires_in":"2020-12-1200:00:00","license_access_token":"dFVzVNBfWiHMAnW6ArZI"}用证码归档电子文件接口调用示例，以JSON格式描述举例，详见表F.4。30DB11/T2290—2024表F.4用证码归档电子文件接口调用示例请求示例POSThttps://{API_ROOT}/license/archive_qr?access_token=ACCESS_TOKENContent-Type:application/JSON“data”:{"auth_code":"AUTH_CODE","service_item_name":"申办事项","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",}}查看电子证照移动端