DB44_T 2167.3-2019广东省电子证照技术规范 第3部分：接口规范.pdf

ICS 35.240.01 L 67 DB44 广东省地方标准 DB44/T 2167.32019 广东省电子证照技术规范 第 3 部分：接口规范 Electronic certificate technical specification Part 3:Interface specification 2019-07-12 发布 2019-10-01 实施 广东省市场监督管理局 发 布 目 次 前言.II 1 范围.1 2 系统接口概述.1 2.1 接口组成.1 2.2 接口技术要求.1 2.3 接口使用.1 3 接口模型及参数.2 3.1 请求模型.2 3.2 返回模型.3 3.3 接口参数.4 附录 A（规范性附录）接口及其参数说明.5 附录 B（规范性附录）公共参数及数据类型.22 附录 C（规范性附录）错误分类代码.27 参 考 文 献.30 前 言 DB44/T 2167广东省电子证照技术规范分为4个部分：第 1 部分：总体构架；第 2 部分：数据规范；第 3 部分：接口规范；第 4 部分：应用与技术管理要求。本部分为DB44/T 2167的第3部分。本部分按照GB/T 1.1-2009给出的规则起草。本部分的附录A、附录B、附录C为规范性附录。本部分由广东省工业和信息化厅提出。本部分由广东省信息技术标准化技术委员会归口。本部分的主要起草单位：工业和信息化部电子第五研究所、广东省信息中心、广东省标准化研究院。本部分主要起草人：周春华、王贵虎、王韬、丁曙初、马晓镌、梁宏、何铤、肖晓赟、黎东初。广东省电子证照技术规范 第 3 部分：接口规范 1 范围 DB44/T 2167的本部分规定了其他电子政务系统与电子证照系统进行对接的接口规范。本部分适用于与政务电子证照系统的对接。2 系统接口概述 2.1 接口组成 电子证照系统应包括电子证照目录查询接口、电子证照信息管理接口、安全会话接口和用证服务接口。a)电子证照目录查询接口 应提供电子证照全省目录、地区和部门应开通目录查询功能。b)证照信息管理接口 应提供电子证照制证、签发、更新、废止等功能。c)安全会话接口 应提供对接入应用和用户身份进行合法性验证等功能。d)用证服务接口 应提供对电子证照进行查询、调用和有效性、归档等功能。2.2 接口技术要求 a)采用基于 Web Service 技术服务接口；b)接口的请求和返回结果采用 JSON 格式；c)应支持跨系统、跨平台调用；d)传输的数据应采用加密和防篡改技术保证数据的完整有效性。2.3 接口使用 接口使用前，应对使用接口的应用系统进行身份认证，确保访问接口的应用都经过授权。认证方式可采用app_key和app_secret方式或CA证书方式。以下给出app_key和app_secret认证方式接口使用可参考流程：其他电子政务系统电子证照系统以app_key和app_secret为参数调用登录接口返回access_token带access_token参数数据访问返回相应数据结束调用返回app_key和app_secret注册和申请授权1234567 图1 接口使用流程图 1)其他电子政务系统向电子证照系统进行应用注册和申请授权；2)审核通过后返回应用唯一标识（app_key）和密钥（app_secret）；3)其他电子政务系统调用登录接口，在参数中加入 app_key 和 app_secret，创建会话；4)电子证照系统返回接入令牌（access_token）；5)在会话有效期内通过加入 access_token 参数进行接口调用；6)电子证照系统返回相应数据；7)会话超时或通过注销接口结束调用。3 接口模型及参数 3.1 请求模型 图2 接口请求模型数据结构 接口请求模型（RequestModel）由接口名称（InterfaceName）、请求参数集（RequestParameterSet）、附件集（AttachmentSet）组成，实线连接内容为必选项，虚线连接内容为可选项。接口名称。接口名称指定将要调用的接口。参数集。结构化请求参数集，登录接口必须包含 app_key 和 app_secret，其它接口必须至少包含请求公共参数。每个参数由参数名（Name）和参数值（Value）、参数类型（Type）组成。附件集 不含或含一个及以上附件。每个附件由附件名（Name）、附件链接地址（URL）、附件类型（Type）、附件内容（Content）和附件描述（Despription）组成，附件链接地址和附件内容至少包含一项。3.2 返回模型 图3 接口返回模型数据结构 接口返回模型（ResponseModel）由返回结果参数集（ResponseParameterSet）、附件集（AttachmentSet）组成。返回结果参数集 结构化的返回结果参数集，应至少包括返回公共参数。每个参数由参数名（Name）和参数值（Value）、参数类型（Type）组成。附件集 附件集为可选内容，不含或含一个以上附件，定义与接口请求模型相同。3.3 接口参数 接口的具体请求和返回参数应符合附录A要求。请求公共参数和返回公共参数应符合附录B.1要求。附 录 A（规范性附录）接口及其参数说明 A.1 安全会话接口 A.1.1 登录 登录是接口系统调用的第一个方法。通过调用登录接口进行身份验证，验证成功后创建一个会话，所有对数据和附件的管理操作都必须在有效的会话内进行，会话应有失效时间。此接口不包含公用参数。请求参数：表 A.1 登录请求参数 参数名 是否必选 类型 说明 app_key 是 String 分配给应用程序的唯一标识 app_key app_secret 是 String 分配给应用程序的密钥 app_secret account 是 String 用户账户名称 password 是 String 用户账户密码 org_code 否 String 以指定的部门管理员身份登录 返回结果：表 A.2 登录返回结果参数 参数名 是否必选 类型 说明 ack_code 是 String 成功：SUCCESS，失败 FAILURE errors 是 String 无错误时为空，有错误返回错误信息 access_token 是 String 登录成功则返回安全会话访问令牌（一天有效）A.1.2 注销 注销当前会话。请求参数：无。（仅包含请求公共参数）返回结果：无。（仅包含返回公共参数）。A.1.3 获取当前已登录用户信息 获取当前已登录用户的信息。请求参数：无。（仅包含请求公共参数）返回结果：表 A.3 注销返回结果参数 参数名 是否必选 类型 说明 data 是 UserInfo 用户信息 A.2 电子证照目录接口 A.2.1 查询全省目录 列举出全省目录清单。请求参数：表 A.4 查询全省目录请求参数 参数名 是否必选 类型 说明 page_index 否 Integer 返回第几页数据。默认值 1 page_size 否 Integer 返回数据的每页大小。默认值 10，最大值 150 keyword 否 String 查询关键字（证照名称，目录编制部门）status 否 LicenseItemStatus 证照状态（默认查询已发布，多个时中间以逗号（,）分割）is_open 否 Boolean 开通状态（默认已开通）注：为兼容现有系统，在接口参数中，使用license英文单词替代certificate使用，下同。返回结果：表 A.5 查询全省目录返回结果 参数名 是否必选 类型 说明 data 是 List 证照目录 A.2.2 查询地区应开通目录 列举出一个地区的应用开通目录清单。请求参数：表 A.6 查询地区应开通目录请求参数 参数名 是否必选 类型 说明 page_index 否 Integer 返回第几页数据。默认值 1 page_size 否 Integer 返回数据的每页大小。默认值 10，最大值 150 keyword 否 String 查询关键字（证照名称，目录编制部门）is_service 否 Boolean 纳入情况 返回结果：表 A.7 查询地区应开通目录返回结果 参数名 是否必选 类型 说明 data 是 List 证照目录 A.2.3 查询部门应开通目录 列举出一个部门的应用开通目录清单。请求参数：表 A.8 查询部门应开通目录请求参数 参数名 是否必选 类型 说明 page_index 否 Integer 返回第几页数据。默认值 1 page_size 否 Integer 返回数据的每页大小。默认值 10，最大值 150 keyword 否 String 查询关键字（证照名称，目录编制部门）is_service 否 Boolean 纳入情况 返回结果：表 A.9 查询部门应开通目录返回结果 参数名 是否必选 类型 说明 data 否 List 证照列表 A.3 电子证照制证接口 A.3.1 创建制证数据接口 按照数据标准，提交证照信息，制作一个电子证照。如果证照带有附件，需要另外调用附件相关接口操作。请求参数：表 A.10 创建制证数据请求参数 参数名 是否必选 类型 说明 data_fields 是 String 证照数据内容 operator 是 UserInfo 制证操作人信息 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应的办件业务流水号 license_group 否 String 照面模板组别名称 seal_code 否 String 印章编码 返回结果：表 A.11 创建制证数据返回结果 参数名 是否必选 类型 说明 license_code 是 String 电子证照标识码 auth_code 是 String 证照查验码 A.3.2 修改制证数据 修改电子证照制证数据。请求参数：表 A.12 修改制证数据请求参数 参数名 是否必选 类型 说明 license_code 是 String 电子证照标识码 data_fields 是 String 证照数据内容 operator 是 UserInfo 制证操作人信息 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 license_group 否 String 照面模板组别名称 seal_code 否 String 印章编码 返回结果：无。（仅包含返回公共参数）A.3.3 删除制证数据 删除电子证照制证数据。请求参数：表 A.13 删除制证数据请求参数 参数名 是否必选 类型 说明 license_code 否 String 电子证照标识码 id_code 否 String 证照号码 operator 是 UserInfo 制证操作人信息 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 注：license_code和id_code不能同时为空。返回结果：无。（仅包含返回公共参数）A.3.4 下载单个附件 根据附件唯一标识获取单个附件数据。请求参数：表 A.14 下载单个附件请求参数 参数名 是否必选 类型 说明 attachment_code 是 String 附件唯一标识 返回结果：表 A.15 下载单个附件返回结果 参数名 是否必选 类型 说明 data 是 Attachment 证件附件信息 A.3.5 下载多个附件 根据电子证照标识码获取证照附件数据。请求参数：表 A.16 下载多个附件请求参数 参数名 是否必选 类型 说明 license_code 是 String 电子证照标识码 返回结果：表 A.17 下载多个附件返回结果 参数名 是否必选 类型 说明 data 是 List 证件附件信息 A.3.6 添加附件数据 添加电子证照附件数据。请求参数：表 A.18 添加附件数据请求参数 参数名 是否必选 类型 说明 license_code 是 String 电子证照标识码 name 是 String 附件名称 file_type 是 String 附件类型（文件后缀）file_data 是 String 附件数据（base64 转码）表 A.18 添加附件数据请求参数（续）参数名 是否必选 类型 说明 is_license_image 否 Boolean 是否作为证照电子影像（默认否）description 否 String 附件描述 返回结果：表 A.19 添加附件数据返回结果 参数名 是否必选 类型 说明 attachment_code 是 String 附件唯一标识 A.3.7 修改附件数据 修改电子证照附件数据。请求参数：表 A.20 修改附件数据请求参数 参数名 是否必选 类型 说明 attachment_code 是 String 附件唯一标识 license_code 是 String 电子证照标识码 name 是 String 附件名称 file_type 是 String 附件类型（文件后缀）file_data 是 String 附件数据（base64 转码）is_license_image 否 Boolean 是否作为证照电子影像（默认否）description 否 String 附件描述 注：attachment_code不能为空。返回结果：无。（仅包含返回公共参数）A.3.8 删除附件数据 删除电子证照附件数据。请求参数：表 A.21 删除附件数据请求参数 参数名 是否必选 类型 说明 license_code 是 String 电子证照标识码 attachment_code 是 String 附件唯一标识 返回结果：无。（仅包含返回公共参数）A.4 电子证照信息管理接口 A.4.1 签发一张证照 签发一张电子证照。请求参数：表 A.22 签发一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 电子证照标识码 id_code 否 String 证照号码 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 签发操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已制证的电子证照，如果存在多条制证的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：无。（仅包含返回公共参数）A.4.2 废止一张证照 废止一张电子证照。请求参数：表 A.23 废止一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 电子证照标识码 id_code 否 String 证照号码 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 废止操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：无。（仅包含返回公共参数）A.4.3 变更一张证照 变更一张证照。请求参数：表 A.24 变更一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 data_fields 是 String 变更后的证照数据内容，用于签发新证 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 变更操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：表 A.25 变更一张证照返回结果 参数名 是否必选 类型 说明 license_code 是 String 变更后的电子证照标识码 auth_code 是 String 证照查验码 A.4.4 加注一张证照 加注一张证照。请求参数：表 A.26 加注一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 data_fields 是 String 加注后的证照数据内容，用于签发新证 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 加注操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：表 A.27 加注一张证照返回结果 参数名 是否必选 类型 说明 license_code 是 String 加注后的电子证照标识码 auth_code 是 String 证照查验码 A.4.5 年检一张证照 年检一张证照。请求参数：表 A.28 年检一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 data_fields 是 String 年检后的证照数据内容，用于签发新证 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 年检操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作；返回结果：表 A.29 年检一张证照返回结果 参数名 是否必选 类型 说明 license_code 是 String 年检后的电子证照标识码 auth_code 是 String 证照查验码 A.4.6 换证一张证照 换证一张证照。请求参数：表 A.30 换证一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 data_fields 是 String 换证后的证照数据内容，用于签发新证 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 换证操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：表 A.31 换证一张证照返回结果 参数名 是否必选 类型 说明 license_code 是 String 换证后的电子证照标识码 auth_code 是 String 证照查验码 A.4.7 挂失一张证照 挂失一张证照。请求参数：表 A.32 挂失一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 挂失操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：无。（仅包含返回公共参数）A.4.8 补发一张证照 补发一张证照。请求参数：表 A.33 补发一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 原电子证照标识码 id_code 否 String 原证照号码 data_fields 是 String 补发后的证照数据内容，用于签发新证 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 补发操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：表 A.34 补发一张证照返回结果 参数名 是否必选 类型 说明 license_code 是 String 补发后的电子证照标识码 auth_code 是 String 证照查验码 A.4.9 吊销一张证照 吊销一张证照。请求参数：表 A.35 吊销一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 电子证照标识码 id_code 否 String 证照号码 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 吊销操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：无。（仅包含返回公共参数）A.4.10 注销一张证照 注销一张证照。请求参数：表 A.35 注销一张证照请求参数 参数名 是否必选 类型 说明 license_code 否 String 电子证照标识码 id_code 否 String 证照号码 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 注销操作人信息 注：（1）license_code和id_code不能同时为空；（2）如果id_code存在多条记录，默认获取已签发的电子证照，如果存在多条签发的电子证照，则提示报错。此种情况只能通过license_code的方式进行操作。返回结果：无。（仅包含返回公共参数）A.5 电子证照用证服务接口 A.5.1 两页系统用证 列举一个持证者所有的电子证照清单，同时对结果清单每一项生成用证码。该接口主要用于两页（市民个人网页、企业专属网页）系统使用。使用这个接口必须先登录实名认证系统获取实名登录凭据。请求参数：表 A.36 两页用证请求参数 参数名 是否必选 类型 说明 page_index 否 Integer 返回第几页数据。默认值 1 page_size 否 Integer 返回数据的每页大小。默认值 10，最大值 150 license_status 否 String 电子证照状态。支持多个，多个时用逗号（,）分隔 credential 是 String 实名登录凭据 token。token_id 是 String 实名登录 tokenId random 是 String 实名登录随机数 返回结果：表 A.37 两页用证返回结果 参数名 是否必选 类型 说明 total_count 否 Integer 记录数 data 否 List 电子证照列表 auth_codes 否 List 用证码列表 A.5.2 持证者用证 列举一个持证者所有的电子证照清单，同时对结果清单每一项生成用证码。该接口主要用于在线申办系统使用。该接口主要用于在线申办系统使用。使用这个接口必须先登录实名认证系统获取实名登录凭据。请求参数：表 A.38 持证者用证请求参数 参数名 是否必选 类型 说明 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 credential 是 String 实名登录凭据 token。token_id 是 String 实名登录 tokenId random 是 String 实名登录随机数 返回结果：表 A.39 持证者用证返回结果 参数名 是否必选 类型 说明 total_count 否 Integer 记录数 data 否 List 电子证照列表 auth_codes 否 List 用证码列表 A.5.3 依职能查验用证 依职能查验用证。根据事项编码以及办事人身份证件号，列举出该办事人在该事项所需要使用的证照，同时对结果清单每一项生成用证码。请求参数：表 A.40 依职能用证请求参数 参数名 是否必选 类型 说明 page_index 否 Integer 返回第几页数据。默认值 1 page_size 否 Integer 返回数据的每页大小。默认值 10，最大值 150 表 A.40 依职能用证请求参数（续）参数名 是否必选 类型 说明 service_item_code 是 String 事项编码 service_item_name 是 String 事项名称 biz_num 否 String 对应办件的业务流水号 operator 是 UserInfo 发起此次用证的业务人员信息。用于记录审计日志。identity_number 是 String 身份证件号码。支持多个，多个时用逗号（,）分隔 返回结果：表 A.41 依职能用证返回结果 参数名 是否必选 类型 说明 total_count 否 Integer 记录数 data 否 List 电子证照列表 auth_codes 否 List 用证码列表 A.5.4 获取证照访问令牌 根据电子证照用证码获取电子证照访问令牌。请求参数：表 A.42 换取访问令牌请求参数 参数名 是否必选 类型 说明 auth_code 是 String 电子证照用证码 返回结果：表 A.43 换取访问令牌返回结果 参数名 是否必选 类型 说明 expires_in 否 String 如果调用成功，返回访问令牌有效期。格式为 yyyy-MM-dd HH:mm:ss.fff license_access_token 否 String 如果调用成功，返回访问令牌 A.5.5 提取证照数据 根据用证码提取一个电子证照的数据。请求参数：表 A.44 提取证照数据请求参数 参数名 是否必选 类型 说明 auth_code 是 String 电子证照用证码 返回结果：表 A.45 提取证照数据返回结果 参数名 是否必选 类型 说明 data 否 License 电子证照数据 A.5.6 获取归档文件 根据用证码获取一张电子证照PDF归档文件。请求参数：表 A.46 获取归档文件请求参数 参数名 是否必选 类型 说明 auth_code 是 String 证照用证码 返回结果：表 A.47 获取归档文件返回结果 参数名 是否必选 类型 说明 file_name 是 String pdf 文件名 file_data 是 String pdf 文件内容数据（base64 编码）A.6 事项与电子证照关系接口 查询事项所需的电子证照和所签的电子证照。A.6.1 查询部门事项 根据主管部门组织机构代码查询服务事项列表。忽略status参数，只返回已发布状态的事项。请求参数：表 A.48 查询部门事项请求参数 参数名 是否必选 类型 说明 org_code 是 String 部门组织机构代码。如果为空，默认指当前登录用户所属的部门。status 是 String 事项状态 返回结果：表 A.49 查询部门事项返回结果 参数名 是否必选 类型 说明 data 是 List 事项信息 A.6.2 查询事项与证照关系 根据事项编号查询所需的电子证照和所签的电子证照。请求参数：表 A.50 查询部门事项请求参数 参数名 是否必选 类型 说明 service_item_code 是 String 事项编码 type 是 String 关系类型（所签 0；所需 1）返回结果：表 A.51 查询部门事项返回结果 参数名 是否必选 类型 说明 data 是 String 事项与证照关系信息 A.7 电子证照网页接口 电子证照网页接口部署在互联网（以下约定部署在互联网的接口URL地址前缀为WEB_ROOT），均采用HTTPS GET方法调用，返回html页面，一般搭配IFrame或弹出页面使用。A.7.1 查看电子证照页面 查看单个电子证照详情页面。请求参数：表 A.52 查看单个证照页面请求参数 参数名 是否必选 类型 说明 license_access_token 是 String 电子证照访问令牌 返回结果：电子证照详情网页。A.7.2 按对象查看电子证照页面 按对象查看电子证照详情页面。请求参数：表 A.53 按对象查看电子证照页面请求参数 参数名 是否必选 类型 说明 license_access_token 是 String 电子证照访问令牌 返回结果：持证者电子证照详情网页。A.7.3 审核签发电子证照页面 签发操作人审核并签发电子证照页面。请求参数：表 A.54 审核签发电子证照页面请求参数 参数名 是否必选 类型 说明 license_access_token 是 String 电子证照访问令牌 返回结果：审核签发电子证照页面。A D 附 录 B（规范性附录）公共参数及数据类型 B.1 公共参数 B.1.1 请求公共参数 表 B.1 接口请求公共参数 参数名 是否必选 类型 说明 access_token 是 String 访问令牌。成功调用 login 接口后返回。sign 否 String 请求参数签名值（预留）sign_cert 否 String 签名证书序列号 sign_method 否 String 签名方法（预留）timestamp 否 Date 应用程序发出请求的客户端时间。服务端在接收到请求后，会与当前服务端时间比较，如果在误差范围大于 10 分钟，将请求视为无效。request_id 否 String 应用程序发出请求的唯一标识号。服务端如果在误差时间内接收到多个 request_id 相同的请求，除最早收到的一个请求外，其它请求将视为重放攻击而被忽略。B.1.2 返回公共参数 表 B.2 接口返回结果公共参数 参数名 是否必选 类型 说明 ack_code 是 String 接口调用是否成功。SUCCESS：成功 FAILURE：失败 errors 否 List 错误信息 sign 否 String 请求参数签名值（预留）sign_method 否 String 签名方法（预留）timestamp 否 Date 接口响应的服务端时间。correlation_id 否 String 对应的请求 request_id。如果请求提供了 request_id 参数，在响应时会原样返回。response_id 否 String 接口返回的唯一标识号。B.2 参数类型 表 B.3 基本数据类型 代码 说明 String 字符型 Date 日期型 Integer 整数型 Float 浮点型 Bytes 字节流制 Boolean 布尔型 List 列表型，Type 为 B.2 定义参数类型 表 B.4 错误信息 Error 类 参数名 是否必选 类型 说明 code 是 String 错误代码 message 是 String 错误信息描述 inner_code 否 String 内部代码，参照附录 C 表 B.5 证照信息 License 类 参数名 是否必选 类型 说明 license_code 是 String 电子证照唯一标识码。由电子证照系统按统一编码规则自动编码。name 是 String 证照中文名称。对应数据证照目录中文名称。license_type 是 String 证照类型（证照执照，证明文件，批文批复，鉴定报告，办事结果）。参照 DB44xx 附录 C 表 C.1 id_code 是 String 证照号码，签发机构编制的证照文号或编号 doc_name 否 String 文书标题 doc_summary 否 String 文书内容概要 doc_keyword 否 String 文书主题词 holder_name 是 String 持证者名称。如有多个，中间以逗号（,）分割。holder_identity_type 是 String 持证者身份证件类型代码。如有多个，中间以逗号（,）分割。holder_identity_num 是 String 持证者身份证件号码。如有多个，中间以逗号（,）分割。issue_org_name 是 String 签发机构名称 issue_org_code 否 String 签发机构的组织机构代码 division 否 String 签发机构所属行政区划 division_code 否 String 签发机构所属行政区划代码 issue_date 是 Date 签发日期 YYYYMMDD，证照签发的业务时间 begin_date 是 Date 证照有效期开始日期 YYYYMMDD expiry_date 否 Date 证照有效期结束日期 YYYYMMDD，没有截止有效日期时，为空 data_fields 是 String 证照业务数据（结构化数据），采用 json 格式记录。attachment_fields 否 String 证照附件数据，采用 json 格式记录。表 B.5 证照信息 License 类（续）trust_level 是 String 证照信息的可信等级。参照 DB44xx 附录 C 表 C.3 remark 否 String 备注 biz_num 否 String 管理属性：签发证照对应办件的业务流水号 license_item_code 是 String 管理属性：目录编码。对应的电子证照目录编码 license_status 是 String 管理属性：证照状态（代码值）。参照 DB44xx 附录 C 表 C.4 creator 否 String 管理