DB36_T 1180-2019 电子证照共享服务系统对接技术规范(高清无水印-可复制）

1、ICS 35.080L 07DB36江西省地方标准DB36/T 11802019电子证照共享服务系统对接技术规范Technical Specification for docking of electronic certificate sharing service system2019 - 12 - 13 发布2019 - 12 - 13 实施江西省市场监督管理局发 布 DB36/T 11802019DB36/T 11802019I II 目次前言II1 范围12 规范性引用文件13 术语和定义14 电子证照系统接入概述25 电子证照系统接入流程36 电子证照系统接口调用5附 录 A （规范

2、性附录） 电子证照系统接入申请表8附 录 B （规范性附录） 电子证照系统接入联调测试报告9附 录 C （规范性附录） 安全会话接口说明11附 录 D （规范性附录） 电子证照目录接口说明13附 录 E （规范性附录） 电子证照制证接口说明14附 录 F （规范性附录） 电子证照生命周期管理接口说明18附 录 G （规范性附录） 电子证照用证服务接口说明22附 录 H （规范性附录） 电子证照接入规范数据模型26 前言本标准按照GB/T 1.12009给出的规则起草。本标准由江西省发展和改革委员会提出并归口。本标准起草单位：江西省信息中心。 本标准主要起草人：金俊平、吴俐、孙杨、李新华、黄振、

3、侯文刚、涂震、彭华大、赵萌、龚清清。 DB36/T 11802019DB36/T 11802019 PAGE 9 PAGE 8 电子证照共享服务系统对接技术规范范围本标准规定了电子证照共享服务系统（以下简称电子证照系统）的概述、接口说明和接入流程。 本标准适用于各级政府部门政务服务系统（以下简称政务服务系统）与电子证照系统对接技术实现。规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 36901-2018 电子证照 总体技术架构GB/T 36906 电子证照 共

4、享服务接口规范 C 0124-2018 国家政务服务平台电子证照跨区域共享服务接入要求 术语和定义GB/T 36901-2018、GB/T 36906、C 0124-2018中界定的以及下列术语和定义适用于本文件。3.1证 照 certificate由机关、团体、企事业单位颁发的、能够证明资格或权利等的凭证类文件。3.2证照目录 certificate catalog依据元数据规范对证照提取特征，并按照一定的分类方法进行排序和编码形成的一组信息。3.3电子证照 electronic certificate由计算机的电子设备形成、传输和存储的证照数据文件。3.4电子证照文件 electronic

5、 certificate file以版式文档表示的电子证照，该文件既包含照面固定版式效果，又包含证照元数据及标识，并应用密码技术保障这些内容的真实性和完整性。3.5电子证照原件 electronic certificate original file由证照颁发机构或其授权机构签署生成的电子证照文件。3.6电子证照加注件 electronic certificate copy file为办理相关事项，在电子证照原件基础上附加用途、有效期限等声明信息并由制作人签署而产生的电子证照文件。3.7政务服务系统 government service system各级政府部门建设的面向社会公众提供政务服务的

6、门户和业务系统。3.8电子证照有效性electronic certificate validity电子证照的凭证效力被其颁发机构继续认可的性质。 电子证照系统接入概述电子证照系统接入架构政务服务系统接入电子证照系统架构示意见图1。发证用证证照索引库电子证照库用证服务接口生命周期管理接口公共服务系统制证签发接口安全会话接口部门业务系统政务服务系统电子证照系统图1 政务服务系统接入电子证照系统架构图电子证照系统功能对接由电子证照系统提供电子证照制证签发、用证服务功能和接口。部门业务系统应与本级电子证照系统对接，实现电子证照制证签发和业务应用。 制证签发对接。部门应实现业务办结出证环节同步签发电子证

7、照。部门业务系统应与制证签发系统对接，包括数据准备、制证处理和正式签发三个步骤：一是基于办事结果生成符合标准规范的证照数据；二是调用制证接口进行制证处理；三是制证成功后调用签发接口进行正式签发。部门业务人员也可使用数字证书Key 登录统一的制证签发系统功能界面，进行数据录入、制证和签发电子证照。使用证照对接。部门应在网上申办、受理审批、归档等业务环节中应用电子证照，实现在线查验使用证照。部门业务系统应与用证服务系统对接，包括明确用证上下文、产生用证码、查验使用证照三个步骤如下：构造上下文，明确用证事由、办事人、所需证照、业务标识、业务环节、业务网点、业务时间、业务部门、经办人员等； 通过上下文

8、调用电子证照用证服务接口，产生有效的用证码； 凭用证码在线查验电子证照有效性、按需提取使用证照数据，获取电子证照原件、电子证照文件或者电子证照加注件。部门业务人员也可使用数字证书 Key 登录统一的用证服务系统功能界面，依职能查验电子证照有效性并使用。 电子证照系统功能定位证照目录：安全会话登录成功后,调用电子证照目录接口。制证部门根据电子证照系统实施人员提供的AppKey 和密钥等参数信息,查询全省电子证照目录，获取证照目录信息。制证签发：调用安全会话接口进行登录，登录成功后才能调用制证签发接口。制证部门根据电子证照系统实施人员提供的数据标准和实施码，依次调用电子证照制证签发接口进行制证和签

9、发，如果证照中包含附件，则需要调用上传附件接口进行附件上传。其中对未签发的证照数据，可以调用删除制证数据接口进行删除再重新调用制证签发接口重新制证签发。用证服务：调用安全会话接口进行登录，登录成功后才能调用用证接口。业务系统调用用证接口获取证照页面URL，通过 URL 访问电子证照系统，将相关的页面嵌入部门业务系统页面中。需要先调用用证码接口传入实名账号系统的相关信息、用证事项名称和事项编号以及触发此次调用的工作人员信息等信息获取用证码。通过该用证码可以直接调用获取电子证照数据接口获取电子证照数据，也可以使用该用证码调用电子证照访问令牌获取接口获取访问令牌，使用访问令牌调用电子证照页面接口查看

10、电子证照详情，也可使用用证码通过调用归档电子文件接口获取电子证照原件、电子证照文件或者电子证照加注件用于业务归档。生命周期管理：调用安全会话接口进行登录，登录成功后才能调用生命周期管理接口。生命周期管理接口包括废止、变更、加注、年检、换证、挂失、补发、吊销、注销等，提供证照生命周期管理服务，业务系统根据实际业务对应调用接口完成业务办理。变更业务：业务系统调用变更接口传入电子证照证照号码相关信息、事项名称和事项编号以及触发此次调用的工作人员信息等信息对原签发的电子证照进行废止，并且对变更后的证照信息重新制证签发为新的电子证照。证照过期：业务系统调用注销接口传入电子证照证照号码信息、事项名称和事项

11、编号以及触发此次调用的工作人员信息等信息对原签发的电子证照进行电子证照注销。电子证照系统接入流程总体流程对接阶段完成系统接入开通接入开通确认（电子证照系统方）接入开通确认（政务服务系统方）完成联调测试报告接入联调（电子证照系统方）接入联调（政务服务系统方）接入改造接入核准接入申请电子证照系统政务服务系统电子证照系统接入流程接入准备准备阶段电子证照系统接入流程示意图，见图2。开通阶段图2 电子证照系统接入流程示意图接入准备各级政府部门政务服务系统应确保与电子证照系统网络互通，明确IP地址和网络策略，制定部署方案、接入方案及安全防护方案。接入申请政务服务部门填写电子证照系统接入申请表，申请表见附录

12、A，并提交各级电子证照系统。接入核准各级电子证照系统根据接入申请表，开设对接部门App账户，禁止泄露调用服务接口所需的AppKey 和密钥，确保只在调用服务接口的后台服务器配置AppKey和密钥。 接入改造各级政府部门政务服务系统根据本文件进行系统改造，调用电子证照系统发证/用证接口实现电子证照的制证签发/事项用证。接入联调各级政府部门政务服务系统与电子证照系统完成接入联调，出具系统接入联调测试报告，报告要求见附录B。接入开通各级电子证照系统建设方、各级政府部门政务服务系统和电子证照系统三方共同确认完成系统接入各项准备工作，正式开通电子证照发证/用证/核验/归档等各项服务功能。电子证照系统接口

13、调用总则电子证照系统接口API按照REST风格设计，通过HTTP协议的GET方法或POST方法提交请求。使用GET方法，请求参数通过URL查询参数（QueryParam）提供。使用POST方法，请求公共参数通过URL 查询参数（QueryParam）提供，接口专用参数通过请求正文（Body）、按照JSON格式封装提供。接口主要功能安全会话：提供对接入电子证照系统的应用系统和用户身份进行合法性验证和授权功能。电子证照目录：提供全省电子证照目录、地区应开通目录、部门应开通目录查询功能；提供事项与证照关系查询功能。制证签发：提供电子证照制证、签发等服务功能。电子证照生命周期管理：提供电子证照废止、变

14、更、加注、年检、换证、挂失、补发、吊销、注销等证照生命周期业务管理功能。用证服务：提供依职能查验用证、获取证照访问令牌、提取证照数据、证照电子归档等服务功能。安全会话接口调用步骤如下： 接口调用方根据电子证照系统提供的AppKey 和密钥等参数信息调用安全会话登录接口，接口说明见附录C 表C.1。电子证照系统接收 AppKey 和密钥进行核验，核验成功返回安全会话访问令牌（一天有效）access_token，接口说明见附录C 表C.1。会话结束调用安全会话退出登录接口，注销当前会话，接口说明见附录C 表C.2。电子证照目录接口调用步骤如下：接口调用方根据电子证照系统提供的AppKey 和密钥等

15、参数信息调用安全会话登录接口，接口说明见附录C 表C.1。根据返回的安全会话访问令牌（一天有效）access_token，调用电子证照目录接口，获取证照目录信息，接口说明详见附录D 表 D.1。登录安全会话退出接口，注销当前会话，接口说明见附录 C 表C.2。制证签发接口调用步骤如下：根据电子证照系统提供的登录参数登录安全会话登录接口，获取 access_token，接口说明见附录 C 表C.1。根据返回的安全会话访问令牌（一天有效）access_token，调用电子证照目录接口，获取电子证照目录信息，接口说明见附录D 表D.1。调用电子证照制证接口，创建电子证照制证数据，接口说明见附录 E

16、表 E.1。调用电子证照添加附件数据接口，根据实际业务可选，接口说明见附录E 表E.2。或调用电子证照PDF 制证核口，创建电子证照PDF 制证数据，接口说明件附录 E 表 E.3。调用电子证照签发接口，提交证照制证数据签发证照，接口说明见附录E 表E.4。调用退出登录接口，接口说明见附录C 表C.2。电子证照生命周期接口调用步骤如下：根据电子证照系统提供的登录参数登录安全会话登录接口，获取 access_token，接口说明见附录 C 表C.1。根据实际业务调用电子证照生命周期管理接口，接口说明见附录 F 各表。调用退出登录接口，接口说明见附录C 表C.2。用证服务接口调用步骤如下：根据电子

17、证照系统提供的登录参数登录安全会话登录接口，获取 access_token（一天有效）， 接口说明见附录C 表C.1。根据电子证照访问令牌调用电子证照依职能查验用证接口，获取证照用证码，接口说明见附录G 表 G.1。根据电子证照用证码调用获取证照访问令牌接口，获取电子证照访问令牌，接口说明见附录 G表 G.2。根据证照访问令牌调用查看电子证照页面接口，查看证照详情，接口说明见附录G 表 G.3。根据电子证照用证码调用提取证照数据接口，获取证照的业务数据（见附录G 表 G.4）。根据电子证照用证码调用归档电子证照文件接口，获取用于归档的电子证照版式文件（PDF 格式），接口说明见附录G 表 G.

18、5。调用退出登录接口，接口说明见附录C 表C.2。附 录 A（规范性附录）电子证照系统接入申请表部门业务系统基本信息部门名称部门业务系统名称系统业务简要说明系统访问地址系统运行网络接入申请联系人信息业务联系人业务联系人电话技术联系人技术联系人电话申请接入单位（盖章）：附 录 B（规范性附录）电子证照系统接入联调测试报告电子证照共享服务系统（建设方）江西省信息中心电子证照共享服务系统（承建方）接入系统（建设方）接入系统（承建商）对接联调报告评审意见致：（江西省信息中心）我单位已完成了接入系统与电子证照共享服务系统的发证用证联调报告的编制工作，现报上，请予以审查和确认。承建单位: 项目经理: 日

19、期 : 电子证照共享服务系统建设单位审查意见（江西省信息中心）：建设单位: 项目负责人: 日 期 : 接入系统建设单位审查意见：建设单位: 项目负责人: 日 期 : 接入系统承建单位审查意见：承建单位: 项目负责人: 日 期 : DB36/T 11802019DB36/T 11802019 PAGE 28 PAGE 27 联调内容对接案例与应用场景案例场景具体应用联调环境与时间测试时间测试版本测试环境浏览器显示标准电子证照系统测试人员接入系统测试人员业主方测试人员联调记录对接结论 附 录 C（规范性附录） 安全会话接口说明登录登录接口表见表C.1。 表 C.1 登录接口表服务名称Login(登

20、录)方法说明通过用户名和密码进行身份验证，验证成功后创建一个会话。所有对数据和附件的管理操作都必须在有效的会话内进行，因此创建会话是接口系统调用的第一个方法。请求方法POSTURL 地址http:/API_ROOT/security/login访问权限合法接入电子证照系统的应用程序输入参数参数名必选类型范围说明app_key是String分配给应用程序的 app_keyapp_secret是String分配给应用程序的 app_secretaccount是String用户账户名称password是String用户账户密码org_code否String以指定的部门管理员身份输出参数access_

21、token是String登录成功则返回安全会话访问令牌（一天有效）请求示例POST http:/API_ROOT/security/login Content-Type: application/jsonapp_key:AppKey, app_secret:AppSecret, account:test_gd_wht, password:abc123返回示例ack_code:SUCCESS, errors:,access_token:ACCESS_TOKEN退出登录退出接口表见表C.2。表 C.2 退出登录接口表服务名称Logout(退出登录)方法说明注销当前会话请求方法POSTURL 地址h

22、ttp:/API_ROOT/security/logout访问权限已登录用户输入参数参数名必选类型范围说明输出参数无请求示例POST http:/API_ROOT/security/logout?access_token=ACCESS_TOKEN Content-Type: application/json返回示例ack_code:SUCCESS, errors: 附 录 D（规范性附录） 电子证照目录接口说明D.1 查询全省证照目录查询全省证照目录接口表见表D.1。表 D.1 查询全省电子证照目录表接口方法说明列举出全省电子证照目录清单请求方法GETURL 地址http:/API_ROOT/

23、license_item/list访问权限已登录用户输入参数参数名必选类型范围说明page_index否Integer返回第几页数据。默认值 1page_size否Integer返回数据的每页大小。默认值 10，最大值150keyword否String查询关键字（证照名称，目录编制部门，电子证照目录编码）status否LicenseItemStatus证照状态（默认查询已发布，多个时中间以逗号（,）分割）is_open否Boolean开通状态（默认已开通）输出参数license_code是String电子证照标识码auth_code是String电子证照查验码请求示例GEThttp:/API_

24、ROOT/license_item/list?access_token=ACCESS_TOKEN&status=PUBLISH & is_open=true返回示例ack_code:SUCCESS,response_id:88429079-bbd6-4a65-a6c5-cad9f806814e, timestamp:2013-06-27 13:38:02.441,errors:, data:license_item_code：100185101,附 录 E（规范性附录） 电子证照制证接口说明创建制证数据创建制证数据接口表见表E.1。表E.1 创建制证数据接口表方法说明创建电子证照制证数据请求方

25、法POSTURL 地址http:/API_ROOT/license/item_code/create访问权限已登录用户输入参数参数名必选类型范围说明data_fields是String证照数据内容operator是UserInfo制证操作人信息，UserInfo 数据模型详见 H.2service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号license_group否String照面模版组别名称seal_code否String印章编码输出参数license_code是String电子证照标识码

26、auth_code是String电子证照查验码请求示例POST http:/API_ROOT/license/006939684360000/create?access_token=ACCESS_TOKEN Content-Type: application/jsondata: service_item_code:事项编码, service_item_name:事项名称, biz_num: 业 务 流 水 号 , operator:account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, se

27、rvice_org:市计生局,division: 上 饶 市 , division_code:360000,data_fields:BIRTHPLACE:江西上饶, PERSON_NAME:李大华, BIRTHDAY:1980-01-15,HOUSEHOLD_ADDRESS:江西省上饶市广丰区龙口路 111 号, IDENTITY_NUMBER返回示例ack_code:SUCCESS,errors:,timestamp:2013-06-27 13:51:12.744,correlation_id:null,response_id:dfc1be0d-ca4

28、f-4a98-bb71-bad846434f8d， data:license_code:36000016D000020，auth_code:36000*0添加附件数据添加附件数据接口表见表E.2。表 E.2 添加附件数据接口表方法说明添加电子证照附件数据请求方法POSTURL 地址http:/API_ROOT/license/item_code/create_attachment访问权限已登录用户输入参数参数名必选类型范围说明license_code是String电子证照标识码name是String附件名称file_type是String附件类型（文件后缀）file_data是String附件

29、数据（base64 转码）is_license_image是Boolean是否作为证照电子影像（默认否）is_show_template否Boolean是否保留通用模板（默认是）description否String附件描述输出参数attachment_code是String附件唯一标识请求示例POST http:/API_ROOT/license/006939684360000/createAttachment? access_token=ACCESS_TOKENContent-Type: application/jsondata:license_code :45252819800115079

30、5, name :附件名称,file_type:测试.txt,timestamp:2013-06-27 14:51:45.597,request_id:d7b44a79-f7a0-4c6a-a345-e6691fd2b56e返回示例ack_code:SUCCESS,errors:, sign:null, sign_method:null,timestamp:2013-06-27 14:51:46.144,correlation_id:null,response_id:b7fdce07-31e5-43d1-83e2-c1ca424aba97, data: attachment_code :001

31、da8b2-0551-49b3-bc 上传PDF文件制证上传PDF 文件制证接口表见表E.3。表 E.3 上传 PDF 文件制证接口表方法说明通过提交PDF 文件，制作一个电子证照。目前用于省工商电子营业执照PDF 制证的方式请求方法POSTURL 地址http:/API_ROOT/license/item_code/pdf_create访问权限已登录用户输入参数参数名必选类型范围说明file_name是Stringpdf 文件名file_data是Stringpdf 数据（base64 编码）division_code是String业务签发地的行政区划operator是UserInfo制证操

32、作人信息，UserInfo 数据模型详见 H.2service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号license_group否String照面模版组别名称seal_code否String印章编码输出参数license_code是String电子证照标识码请求示例POSThttp:/API_ROOT/license/ item_code /pdf_create?access_token=ACCESS_TOKEN Content-Type: application/jsondata:fil

33、e_name : 3600000000017919036000020160918123721000000862528 .pdf,file_data :BDAAUDBAQE/Z, service_item_code:事项编码, service_item_name:事项名称, biz_num: 业 务 流 水 号 , operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, service_org:市计生局,division:上饶市,division_code:360000,返

34、回示例ack_code:SUCCESS,errors:,timestamp:2013-06-27 13:51:12.744,correlation_id:null,response_id:dfc1be0d-ca4f-4a98-bb71-bad846434f8d， data:license_code:36000016D000020签发一张证照制作签发一张证照接口表见 E.4。表 E.4 签发一张证照接口表方法说明正式签发一张电子证照请求方法POSTURL 地址http:/API_ROOT/license/item_code/sign访问权限已登录用户输入参数参数名必选类型范围说明license_

35、code否String电子证照标识码id_code否String证照号码service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo签发操作人信息, UserInfo数据模型详见 H.2输出参数返回公共参数请求示例POST http:/API_ROOT/license/006939684360000/sign? access_token=ACCESS_TOKENContent-Type: application/jsondata:license_code: 36

36、000015D00000B, service_item_code:事项编码, service_item_name:事项名称, biz_num:业务流水号,operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, service_org:市计生局,division:上饶市,division_code:360000返回示例ack_code:SUCCESS, errors:,sign:null, sign_method:null, timestamp:null, correlat

37、ion_id:null,response_id: dfc1be0d-ca4f-4a98-bb71-bad846434f8d 附 录 F（规范性附录）电子证照生命周期管理接口说明废止一张证照废止一张证照接口表见 F.1。表 F.1 废止一张证照接口表方法说明废止一张电子证照请求方法POSTURL 地址http:/API_ROOT/license/item_code/abolish访问权限已登录用户输入参数参数名必选类型范围说明license_code否String电子证照标识码id_code否String证照号码service_item_code是String事项编码service_item_n

38、ame是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo废止操作人信息, UserInfo 数据模型详见 H.2输出参数返回公共参数请求示例POST http:/API_ROOT/license/006939684360000/abolish? access_token=ACCESS_TOKEN Content-Type: application/jsondata:license_code: 36000015D00000B, service_item_code:事项编码, service_item_name:事项名称, biz_num:业务

39、流水号,operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, service_org:市计生局,division: 上 饶 市 , division_code:360000返回示例ack_code:SUCCESS, errors:, timestamp:null, correlation_id:null,response_id: dfc1be0d-ca4f-4a98-bb71-bad846434f8d变更一张证照变更一张证照接口表见 F.2。表 F.2 变更一张证照接口

40、表方法说明变更一张电子证照请求方法POSTURL 地址http:/API_ROOT/license/item_code/change访问权限已登录用户输入参数参数名必选类型范围说明license_code否String原电子证照标识码id_code否String原证照号码data_fields是String变更后的证照数据内容， 用于签发新证service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo变更操作人信息, UserInfo数据模型详见 H.2输出参数

41、返回公共参数请求示例POST http:/API_ROOT/license/006939684360000/change? access_token=ACCESS_TOKENContent-Type: application/jsondata:license_code: 36000015D00000B, service_item_code:事项编码, service_item_name:事项名称, biz_num:业务流水号,operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科

42、室科员, service_org:市计生局,division:上饶市,division_code:360000返回示例ack_code:SUCCESS, errors:, timestamp:null, correlation_id:null,response_id: dfc1be0d-ca4f-4a98-bb71-bad846434f8d data:license_code:36000016D000020，auth_code:36000*0注销一张证照注销一张证照接口表见 F.3。表 F.3 注销一张证照接口表方法说明注销一张电子证照请求方法POSTURL 地址http:/API_ROOT/

43、license/item_code/cancel访问权限已登录用户输入参数参数名必选类型范围说明license_code否String电子证照标识码id_code否String证照号码service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo注销操作人信息, UserInfo 数据模型详见 H.2输出参数返回公共参数请求示例POST http:/API_ROOT/license/006939684360000/cancel? access_token=ACCE

44、SS_TOKEN Content-Type: application/jsondata:license_code: 36000015D00000B, service_item_code:事项编码, service_item_name:事项名称, biz_num:业务流水号,operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, service_org:市计生局,division:上饶市,division_code:360000返回示例ack_code:SUCCESS, e

45、rrors:, timestamp:null, correlation_id:null,response_id: dfc1be0d-ca4f-4a98-bb71-bad846434f8d换证一张证照换证一张证照接口表见 F.4。表 F.4 换证一张证照接口表方法说明换证一张电子证照请求方法POSTURL 地址http:/API_ROOT/license/item_code/renew访问权限已登录用户输入参数参数名必选类型范围说明license_code否String原电子证照标识码id_code否String原证照号码data_fields是String换证后的证照数据内容， 用于签发新证s

46、ervice_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo换证操作人信息, UserInfo数据模型详见 H.2输出参数返回公共参数请求示例POST http:/API_ROOT/license/006939684360000/renew? access_token=ACCESS_TOKENContent-Type: application/jsondata:license_code: 36000015D00000B, service_item_code:事项编

47、码, service_item_name:事项名称, biz_num:业务流水号,operator: account:gz_rjj ,name: 张 三 , identity_num role:市计生局 xx 科室科员, service_org:市计生局,division:上饶市,division_code:360000返回示例ack_code:SUCCESS, errors:, timestamp:null, correlation_id:null,response_id: dfc1be0d-ca4f-4a98-bb71-bad846434f8d da

48、ta:license_code:36000016D000020，auth_code:36000*0 附 录 G（规范性附录）电子证照用证服务接口说明依职能查验用证依职能查验用证接口表见表G.1。表 G.1 依职能查验用证接口表方法说明依职能查验用证。根据事项编码以及办事人身份证件号，列举出该办事人在该事项所需要使用的证照，同时对结果清单每一项生成用证码。该接口主要在部门业务审批办理系统使用请求方法POSTURL 地址http:/API_ROOT/license/auth访问权限所有已登录用户输入参数参数名必选类型范围说明page_index否Integer返回第几页数据。默认值 1page_s

49、ize否Integer返回数据的每页大小。默认值 10，最大值150service_item_code是String事项编码service_item_name是String事项名称biz_num否String对应办件的业务流水号operator是UserInfo发起此次用证的业务人员信息。用于记录审计日志。UserInfo 数据模型详见 H.2identity_number是String证件号码。多个时用逗号（,）分隔输出参数参数名必选类型范围说明total_count否Integer记录数data否List电子证照列表，License 数据模型详见 H.1auth_codes否List用证码

50、列表请求示例POST http:/API_ROOT/license/auth?access_token= ACCESS_TOKEN Content-Type: application/jsonservice_item_code:事项编码, service_item_name:事项名称, biz_num: 业 务 流 水 号 , operator: account:js_abc ,name: 张 三 , identity_num:440102*, role:省计生局 xx 科室科员, service_org:市计生局,division:上饶市,division_code:360000,ident

51、ity_number:440102*表 G.1 依职能查验用证接口表(续)ack_code:SUCCESS,errors:, total_count:1,auth_codes: aaa, bbb, data:data_fields: license_code:010119432342342,name: 身 份 证 , issue_org_name:省公安厅, issue_org_code:1111111, issue_date:2012-12-12, expiry_date:2012-12-12, version:1,creator:test, creation_time:2012-12-1,

52、 last_modificator:test,last_modification_time:2012-12-2,返回示例获取证照访问令牌获取证照访问令牌接口表见表G.2。表 G.2 获取证照访问令牌接口表方法说明根据电子证照用证码（auth_code）获取电子证照访问令牌（license_access_token）请求方法GETURL 地址http:/API_ROOT/license/token访问权限所有合法第三方程序输入参数参数名必选类型范围说明auth_code是String电子证照用证码输出参数参数名必选类型范围说明expires_in否String如果调用成功，返回访问令牌有效期。格

53、式为 yyyy-MM-dd HH:mm:ss.ffflicense_access_token否String如果调用成功，返回电子证照访问令牌请求示例GET http:/API_ROOT/license/token?access_token=ACCESS_TOKEN &auth_code=AUTH_CODE返回示例expires_in:2014-12-12 00:00:00.000,license_access_token:dFVzVNBfWiHMAnW6ArZI查看电子证照页面查看电子证照页面接口表见表G.3。 表 G.3 查看电子证照页面接口表方法说明显示单个电子证照的详情页面请求方法GET

54、URL 地址http:/WEB_ROOT/license/view_license访问权限所有已登录用户输入参数参数名必选类型范围说明auth_code是String电子证照用证码输出参数参数名必选类型范围说明data否License电子证照，License 数据模型详见H.1请求示例http:/WEB_ROOT/license/view_license?license_access_token=LICENSE_ACCESS_TOK EN返回示例显示单个电子证照的详情页面提取证照数据提取证照数据接口表见表G.4。 表 G.4 提取证照数据接口表方法名称get_license(提取证照数据)方法

55、说明根据用证码提取一个电子证照的信息请求方法GETURL 地址http:/API_ROOT/license/get_license访问权限所有已登录用户输入参数参数名必选类型范围说明auth_code是String电子证照用证码输出参数参数名必选类型范围说明data否License电子证照, License 数据模型详见 H.1请求示例GEThttp:/API_ROOT/license/get_license?access_token=ACCESS_TOKEN&auth_code AUTH_CODE返回示例ack_code:SUCCESS,errors:,data:data_fields: l

56、icense_code:010119432342342,name: 身 份 证 , issue_org_name:省公安厅, issue_org_code:1111111, issue_date:2012-12-12, expiry_date:2012-12-12, version:1,creator:test, creation_time:2012-12-1, last_modificator:test,last_modification_time:2012-12-2归档电子文件归档电子文件接口表见表G.5。表 G.5 归档电子文件接口表方法说明根据电子证照用证码获取用于归档的电子证照文件（

57、PDF 格式）请求方法GETURL 地址https:/API_ROOT/license/archive访问权限所有已登录用户，并已通过实名账号系统获取访问令牌输入参数参数名必选类型范围说明auth_code是String电子证照用证码file_type否String电子文件类型（PDF 格式）。输出参数参数名必选类型范围说明file_name是Stringpdf 文件名file_data是Stringpdf 文件内容数据（base64 编码）请求示例GEThttps:/API_ROOT/license/archive?auth_code=AUTH_CODE &access_token=ACCESS_TOKEN返回示