（正式版）DB11∕T 2290-2024 《电子证照共享服务系统接入技术要求》

DF1/T2290—20242024-10-01实施2024-10-01实施I 1 1 1 2 25.1接入内容 2 2 35.1接入安全 36电子证照共享服务系统接口要求 4 46.2安全会话接口 46.3电子证照目录查询接口 56.4电子证照制证接口 66.5电子证照操作发布接口 76.6电子证照持证主体授权服务接口 96.7电子证照依职能查验用证接口 附录A(资料性)电子证照共享服务系统接入申请 A.1电子证照共享服务系统接入申请表 附录B(资料性)安全会话接口调用示例 16 16B.3获取当前已登录用户信息接口调用示例 附录C(资料性)电子证照目录查询接口调用示例 C.1电子证照目录查询接口调用示例 18附录D(资料性)电子证照制证接口调用示例 D.1创建制证数据接口调用示例 D.2修改制证数据接口调用示例 D.3删除制证数据接口调用示例 附录E(资料性)电子证照操作发布接口调用示例 22E.2变更一张证照接口调用示例 23E.3废止一张证照接口调用示例 IIE.4批量制作证照接口调用示例 附录F(资料性)电子证照持证主体用证服务接口调用示例 F.1统一身份认证用证接口调用示例 F.2用证码提取证照数据接口调用示例 28F.3用证码换取访问令牌接口调用示例 F.4用证码归档电子文件接口调用示例 附录G(资料性)电子证照用证服务接口调用示例 G.2获取证照访问令牌接口调用示例 G.3提取证照数据接口调用示例 G.4查看电子证照页面接口调用示例 III起草。1仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本2准备阶段对按阶段开通阶段5.4.1传输安全45.4.4会话安全地址、访问权限、请求参数、返回结果等接口描述，应符合表1、表2、表3的相接口名称接口说明通过用户名和密码进行身份验证，验证成功后创建会话。所有管理操作均应在有效的会话内进https://{API_ROOT}/security参数名类型范围是是是是否以指定的部门管理员身份登录5是登录成功则返回安全标识是方法说明URL地址https://{API_ROOT}/securit已登录用户get_current_user方法说明获取当前已登录用户的信息https://{API_ROOT}/security/get_curren已登录用户参数名类型范围是用户信息方法说明查询电子证照目录的元数据信息https://{API_ROOT}/license_ite已登录用户参数名类型范围说明否返回第几页数据，默认值1否返回数据的每页大小，默认值10,否查询关键字(证照名称，目录编制6表4电子证照目录查询接口(续)否时中间以逗号[,]分割)否开通状态(默认已开通)是电子证照目录的元数据信息方法说明https://{API_ROOT}/license/{item_code}/已登录用户参数名类型范围说明是是制证操作人信息是是biz_num否否照面模版组别名称是印章编码是证照唯一编码是电子证照用证码方法说明https://{API_ROOT}/license/{item_code}/已登录用户参数名类型范围说明是证照唯一编码是证照数据内容是制证操作人信息7是service_item_na是biz_num否否照面模版组别名称否印章编码方法说明https://{API_ROOT}/license/{item_code}/de已登录用户参数名类型范围说明是否是制证操作人信息是service_item_na是否方法说明签发电子证照https://{API_ROOT}/license/{ite已登录用户参数名类型范围是证照唯一编码是证照号码8是是biz_num否是签发操作人信息表9变更证照接口方法说明变更电子证照https://{API_ROOT}/license/{item_code}/已登录用户参数名类型范围是原证照唯一编码否原证照号码是是是否是变更操作人信息是是电子证照用证码方法说明废止电子证照https://{API_ROOT}/license/{item_code}/abolish已登录用户参数名类型范围是否是是9biz_num否是方法说明批量制证接口https://{API_ROOT}/license/{item_code}/batch_已登录用户参数名类型范围是参数名是service_item_na是否申办流水号是当前用户信息(业务人员信息)是证照唯一编码方法说明列举一个持证人所有的电子证照清单，同时对结果清单每一项生成用证码。证系统使用https://{API_ROOT}/license/psn_参数名说明否返回第几页数据，默认值为1否是实名登录凭据token,持证主体代码否电子证照列表否方法说明https://{API_ROOT}/license/g所有已登录用户参数名说明是电子证照用证码是是否是用于记录审计日志是电子证照方法说明https://{API_ROOT}/license/get_to参数名类型范围是电子证照用证码是当前操作人信息是是否是如果调用成功，返回访问令牌有效期。是方法说明https://{API_ROOT}/license/arch参数名类型范围是电子证照用证码否电子文件类型，默认为0FD是service_item_na是service_item_org是是是0FD文件名是0FD文件内容数据(base64编码)方法说明https://{WEB_ROOT}/license/view_mobile参数名类型范围是电子证照访问令牌方法说明依职能查验用证。根据事项编码以及办事人身份证件号，列举出该办事人在该事项所需要用的证照，同时对结果清单每一项生成用证码。该接口主要在部门业务审批办理系统使用https://{API_ROOT}/licens所有已登录用户参数名类型范围否返回第几页数据，默认值1否是是否显示敏感数据显示为true不显示为falsebiz_num否是发起此次用证的业务人员信息，用于记录审计日志是证件号码，多个时用逗号(,)分隔否否电子证照列表否方法说明根据电子证照用证码(auth_code)获取电子证照访问令牌(license_access_token)所有已登录用户参数名是电子证照用证码否否方法说明根据用证码提取一个电子证照的信息https://{API_ROOT}/license/get_l所有已登录用户参数名类型范围是电子证照用证码否电子证照结构化数据方法说明https://{WEB_ROOT}/license/view_l参数名类型范围license_access_是电子证照访问令牌电子证照展示页面a)根据提供的登录参数调用登录接口；c)调用电子证照制证接口；e)调用退出登录接口。f)调用退出登录接口。e)调用退出登录接口。d)调用退出登录接口。(资料性)单位统一社会信联系人姓名上级主管部门□安全会话□电子证照目录查询□电子证照制证□电子证照操作发布□电子证照持证主体授权服务□电子证照依职能查验用证对应证照印章信息部门(盖章):时间：年月日(资料性)请求示例POSThttps://{API_ROOT}/security/loginContent-Type:applicat"app_secret":"APP_SECRET",}返回示例}请求示例POSThttps://{API_ROOT}/security/logout?access_token=ACCESSContent-Type:applicat{}返回示例请求示例GEThttps://{API_ROOT}/security/get_current_user?access_token=ACCESS_TOKEN返回示例{{"name":"北京市管理员","identity_num":"11010"division":“北京市”,"last_modification_ti}}(资料性)请求示例返回示例"response_id":"88429079-bbd6-4a65-a6c5-cad9"timestamp":"2020-06-2715:}(资料性)请求示例https://{API_ROOT}/license/006939684110000/create?access_token=ACCContent-Type:applicati"service_item_code":"事项编码",“service_item_name”:"事项名称”,“biz_num”:"业务流水号”,"name”:"张XX","identity_num":"110105*"role":"市XX局XX处室科员","service_org":"市XX局","division":"朝阳区",}}"BIRTHPLACE":"北京","PERSON_NAME":"李XX","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","IDENTITY_NUMBER":"110105{}返回示例"timestamp":"2020-06-2310:"response_id”:"dfclbeOd-ca4f-4"data":{"license_code":"11000016D000020","auth_code":"1100}请求示例https://{API_ROOT}/license/006939684110000/update?access_token=ACCESContent-Type:applicati{{"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","name":"张XX","role":“市XX局XX处室科员”,"service_org":“市XX局”,"division":“朝阳区”,{}"BIRTHPLACE":"北京","PERSONNAME":"李XX","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","IDENTITY_NUMBER":"110105*}返回示例"timestamp":"2020-06-2310:"response_id":"dfclbeOd-ca4f-4a98-bb}请求示例https://{API_ROOT}/license/006939684Content-Type:applicat{"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号",“name”:"张XX","identity_num":"11010"role":"市XX局XX处室科员","service_org":“市XX局”,“division”:"朝阳区”,}}}返回示例"timestamp":"2020-06-2310:"response_id”:"dfclbeOd-ca4f-4a38-bb7}22(资料性)请求示例https://{API_ROOT}/license/006939684110000/sign?access_token=ACContent-Type:applicat"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","name":"张XX","identity_num":"110105*"role":"市XX局XX处室科员","service_org":"市XX局","division":"朝阳区",返回示例"response_id":"dfclbeOd-ca4f-4a98-bb71-23E.2变更一张证照接口调用示例请求示例https://{API_ROOT}/license/006939684110000/change?aContent-Type:applicat{"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","name":"张XX","identity_num":"110105*****"role":"市XX局XX处室科员","service_org":"市XX局","division":“朝阳区”,}}"BIRTHPLACE":"北京","PERSON_NAME":"李XX","HOUSEHOLD_ADDRESS":"北京市朝阳区朝阳路111号","IDENTITY_NUMBER":"110105}}返回示例"timestamp":"2020-06-2310:"response_id":"dfclbeOd-ca4f-4"data":{"license_code":"11000016D000020","auth_code":}请求示例https://{API_ROOT}/license/006939684110000/abolish?access_token=ACCESContent-Type:applicati{"service_item_code":"事项编码","service_item_name":"事项名称","biz_num":"业务流水号","name":"张XX","identity_num":"11010"role":"市XX局XX处室科员","service_org":"市XX局","division":"朝阳区",}}返回示例"response_id”:"dfclbeOd-ca4f-4a3}请求示例https://{API_ROOT}/license/305018201/batch_create?access_token=ACCESContent-Type:applicati{{"POGJ":"中国","CZRXB":“男”,"FZJGMC":"北京市XX局","HYDJY":"张XX","CZRGJ":"中国","POXB":"女","ZZMC":"XX证","POSFZJH":“110102************”}26请求示例"POGJ":“中国”,"CZRXB":“男”,"FZJGMC":"北京市XX局","HYDJY":"张XX","CZRGJ":"中国","CYRSFZJHM":"110103*"POXB":“女”,"ZZMC":"XX证","service_org":"北京市XX局","division”:"北京市","role":"内地居民婚姻登记角色","name":"张XX""service_item_code""service_item_name":"婚姻登记",{}返回示例{"response_id”:"bc90eb57-422c-4c0e-a94]}}(资料性)请求示例https://{API_ROOT}/license/webpage?access_token=ACCEContent-Type:applicati"credential":"MCK0102*"random":”************”返回示例"auth_codes”:["aaa",“name”:"身份证”,"issue_org_name":"市XX局","issue_org_code":"11************4550","creation_time":"2020-"last_modification_ti}请求示例https://{API_ROOT}/license/get_license_qr?accesstokeContent-Type:applicat"auth_code":"AUTH_CODE","service_item_name”:"申办事项","biz_num":"1002180000069397"operator":{"name”:"张XX","identity_num":"11010"role":"市XX局XX处室科员","service_org":"市XX局","division":"北京市",}}}返回示例{"license_code":"010119432342342“name”:"身份证”,"issue_org_name":"市XX局","issue_org_code":"11***********4550",//取值为18位"last_modification_ti}}}请求示例https://{API_ROOT}/license/get_token_qr?access_tContent-Type:applicati“auth_code”:”1235815”,"service_item_code":"事项编码","service_item_name":"事项名称",“operator”:{…}}返回示例"errmsg":””,"expires_in":"2020-"license_access_token":"dFVZVN请求示例https://{API_ROOT}/license/archive_qr?access_token=ACCESContent-Type:applicat"auth_code":"AUTH_CODE"service_item_name":"申办事项","biz_num":"1002180000069397"name”:"张XX","identity_num":"11010"role":"市XX局XX处室科员","service_org":"市XX局","division":"北京市",}"terminal_info":"192.1"timestamp":"2020-10-"request_id":"b2629b80-a96f-469b-87f}}返回示例{