ICS35.020 CCSL80DB3704 枣庄市地方标准 DB3704/T0042-2024 电子证照共享服务平台证照 数据对接技术规范 2024-03-27发布 2024-04-27实施 枣庄市市场监督管理局发布DB3704/T0042—2024 目次 前  言..............................................................................1 电子证照共享服务平台证照数据对接技术规范..............................................2 1范围................................................................................2 2规范性引用文件......................................................................2 3术语和定义..........................................................................2 4公用服务............................................................................5 4.1接口使用须知....................................................................5 4.2对接须知........................................................................5 4.3接口列表........................................................................5 5字典数据...........................................................................43 5.1持证主体代码类型代码...........................................................43 5.2接口返回值列表.................................................................44 5.3证照类型列表...................................................................44DB3704/T0042—2024 1前  言 本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起 草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由枣庄市大数据局提出、归口并组织实施。 本文件起草单位：枣庄市大数据中心、南威软件股份有限公司。 本文件主要起草人：陈夫真、赵瑞欣、赵荣、陈亚楠、郗金鑫、苗媛媛、王振、孙竹梅、韩帮冉、 褚萌、马亮。 本文件为首次发布。DB3704/T0042—2024 2电子证照共享服务平台证照数据对接技术规范 1范围 本技术规范设计是为了规范第三方业务系统如何生成、管理、查询、获取电子证照，如网上办事大 厅、行政审批系统、办公或颁证业务系统等，接口支持多种开发语言的接入，定义统一的数据对接标准， 提供可靠性、安全性、规范化的接口标准。 本规范的阅读对象是业务系统的软件开发人员、各项目管理与开发人员。 本规范部分接口配套提供基础的调试DEMO，开发人员可根据实际情况自行扩展DEMO。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件, 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB∕T36901-2018电子证照总体技术架构 GB∕T36902-2018电子证照目录信息规范 GB∕T36903-2018电子证照元数据规范 GB∕T36904-2018电子证照标识规范 GB∕T36905-2018电子证照文件技术要求 GB∕T36906-2018电子证照共享服务接口规范 ZWFWC0123-2018国家政务服务平台证照类型代码及目录信息 ZWFWC0124-2018国家政务服务平台电子证照跨区域共享服务接入要求 3术语和定义 GB∕T36901-2018、GB∕T36902-2018、GB∕T36903-2018及GB∕T36904-2018界定的以及下 列术语和定义适用于本文件。 3.1 证照 由机关、团体、企事业单位颁发的，能够证明资格或权利等的凭证类文件。 注：证照包括证件和执照等。 [来源:GB/T36901-2018，3.1] 3.2 接口角色及分类DB3704/T0042—2024 3用于接口授权中的角色及接口日志的分类管理，通常根据业务的应用场景定义，分为检索证照、下 载证照、获取信息、查看证照等。 3.3 电子证照 由计算机等电子设备形成、传输和存储的证照数据文件。 [来源:GB/T36901-2018，3.3] 3.4 证照照面 电子证照可视内容的直接表现形式，包含图像和文字信息两种形式，与实体证照保持一致。 3.5 电子证照文件 以版式文档表示的电子证照，该文件既包含照面固定版式效果，又包含证照元数据及标识，并应用 密码技术保障这些内容的真实性和完整性。 [来源:GB/T36901-2018，3.4] 3.6 证照目录信息 揭示电子证照文件主要内容和形式特征的条目信息集合，是证照管理、共享和服务的基本工具。 3.7 XML 可扩展置标语言（eXtensibleMarkupLanguage）。 3.8 Base64编码 Base64内容传送编码被设计用来把任意序列的8位字节描述为一种不易被人直接识别的形式。 3.9 JSON格式 JSON（JavaScriptObjectNotation）是一种轻量级的数据交换格式。易于人阅读和编写，可以在 多种语言之间进行数据交换。同时也易于机器解析和生成。 3.10 Token 令牌，代表执行某些操作的权利的对象。是一串字符,用于标识用户的身份和权限,通常包含一些加 密信息,以确保其安全性。DB3704/T0042—2024 43.11 RESTful 一般指REST，即表述性状态传递（英文：RepresentationalStateTransfer，简称REST）是一种 软件架构风格。它是一种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩 性。 3.12 OAuth2.0 一种用户验证和授权的互联网标准协议，该协议要么通过组织在资源拥有者和HTTP服务商之间的被 批准的交互动作代表用户，要么允许第三方应用代表用户获得访问的权限。同时为Web应用，桌面应用 和手机，和起居室设备提供专门的认证流程。 唯一凭证KEY：接口传输中用与标识身份的签名字段； 凭证密钥：与凭证一起使用，用于确认接口调用者身份。 3.13 认证机制 使用凭证+凭证密钥的方式进行接口认证，除了“4.3.1用户身份验证接口”以外的每个接口访问时 都要带认证信息access_token(简称叫token)，此token是通过“4.3.1用户身份验证接口”的返回结果 中的“access_token”参数获取的。 3.14 编码格式 数据的接收与发送统一使用UTF-8编码。 3.15 数据规约 接口数据传输使用JSON格式，数据的提交使用HTTP协议的POST标准。 数据返回包含有消息头head如下示例： {"head":{"message":"获取成功","status":0},"data":{"total":0,"data":[]}}。 3.16 服务类型 电子证照国标共享服务：根据电子证照国家标准中的共享服务接口规范提供的相关接口。 3.17 服务方式 a）推荐通过共享服务系统发布为Webservice或RESTful服务； b）RESTful服务直接调用。DB3704/T0042—2024 54公用服务 4.1接口使用须知 电子证照共享服务接口以GB/T36901-2018中指出的电子证照系统与业务系统之间的交互关系为应 用场景，电子证照系统是共享服务的提供方，业务系统是共享服务的调用方。 4.2对接须知 a)由业务部门向共享平台申请接口权限，审批后接口发给电子证照项目组开通权限； b）系统根据部门申请信息分配username（访问标识）、password（应用认证信息），并邮件发送 至对接单位的相关人员； c）业务部门对接时向电子证照项目组索要访问地址的IP和port端口号。 4.3接口列表 4.3.1用户身份验证接口 接口说明： 此接口用于获取access_token串,其他接口都需要此接口返回的token作为入参。 调用路径： http://ip:port/license-api-release/oauth/token 接口调用请求说明： http请求方式:POST 参数说明： 参数 是否必须 说明 client_id 是 固定值为：xxxx-oauth client_secret 是 固定值为：xxxx-mobile grant_type 是 固定值为：password scope