本文目录导航指引
锚点跳转定位可能存在轻微页面滚动偏差，跳转后请上下滚动页面查看。
建议开发者先仔细阅读本文再查阅相关接口文档，整体了解数据存证流程后，可提高后续接口开发效率。
1.服务简介
1.1 服务概述
区块链数据存证API是e签宝提供的一种电子存证开放服务能力。
企业开发者在自己的业务系统中可以通过调用数据存证API服务所提供的接口实现已签署PDF文件的存证或其他希望存证的数据信息。
1.2 服务特点
- 纯接口调用，无e签宝页面嵌入，企业开发者可以根据自己的业务系统实际情况灵活进行交互设计；
- 允许企业开发者上传PDF文件、DOC文档、图片文件和音频、视频等文件到e签宝进行存证；
- 允许企业开发者单独对接e签宝认证服务API和电子签名服务SDK进行组合使用；
- 可以将数据同步到国家权威机构以便日后出现纠纷时快速便捷出具存证相关报告；
1.3 适用场景
- 企业开发者希望将签署后的PDF文件或其他证据数据上传到第三方存证平台进行存证备份；
- 企业开发者希望能够便捷向用户展示使用了第三方存证，以便保证其文件或数据的防篡改；
2.名词解释
企业开发者：
集成e签宝各服务接口的企业开发团队。
平台方：
在e签宝官网注册企业账号并完成企业实名且直接开通/对接e签宝各服务接口的企业账户。
平台用户：
平台方自己的个人客户或企业客户。
存证：
电子存证其实就是把一些电子证据存储在服务器中，类似“网盘”。与“网盘”所不同的是电子存证的目的是为防止电子数据私自篡改事件的发生而保存证据。
出证：
出证就是把通过电子存证方式保存的证据进行提取。使用e签宝电子存证服务后可以申请出具《e签宝服务证明》、《公证书》、《司法鉴定报告》。
区块链数据存证API：
区块链数据存证API是指企业开发者在进行电子文件存证时同时将电子文件签署过程中涉及的数据也进行存证。以下区块链数据存证API统一描述为数据存证。
存证数据字典：
用于e签宝的数据存证服务中展示企业开发者自定义的需要存储或展示的字段信息。
证据点（证据点ID）：
证据点是数据存证中的最小存证单元，企业开发者每存储一个证据点均会获取一个证据点ID。证据点必须关联到证据链（存证编号）上才算完成存证，才可以进行存证查询和出证。证据点又称证据点ID，以字母H开头，如：H953731243202080768。
证据链（存证编号）：
e签宝的数据存证中用于将多个证据点关联到一起的编号ID，形成一个完整的证据链条。可以将日后向用户在线展示存证信息或出具存证报告时均需要通过该证据链编号查询。证据链又称为存证编号，以字母C开头，如：C953740579206885376。
3.接入方式
数据存证API服务提供一组Web API接口，企业开发者可以通过HTTP方式调用接口进行存证。
4.业务流程
1.定义数据存证数据字典
属于准备工作,主要用于定义基础数据以便“构建证据链”时直接使用，数据字典创建一次即可多次使用（永久有效）。
其涉及子流程如下：
定义所属行业类型，可查看接口列表中的[定义所属行业类型]接口。
定义业务凭证（名称），可查看接口列表中的[定义业务凭证（名称）]接口。
定义业务凭证中某一证据点名称，可查看接口列表中的[定义业务凭证中某一证据点名称]接口。
定义业务凭证中某一证据点的字段属性，可查看接口列表中的[定义业务凭证中某一证据点的字段属性]接口。
2.创建证据链
属于具体的存证操作,主要用于将原文存证 、摘要存证等证据点进行串联，形成一个完整的证据链。
创建证据链，获取一个数据存证编号。可查看接口列表中的[创建证据链]接口。
3.创建证据点
创建证据点，证据点可以是合同文件、合同文件的SHA256摘要值或业务数据。
如果要存证电子文件，可查看接口列表中的[创建原文存证证据点]接口，同时查看[上传待存证的文档]接口把文件进行上传。
4.追加证据点
追加证据点，将证据点追加到已存在的证据链内形成证据链。可查看接口列表中的[追加证据点]接口。
5.存证编号关联到用户
将数据存证编号与用户的证件号进行关联后，在需要出证时该用户可登录e签宝官网进行在线申请或通过存证查看链接查看。
可查看接口列表中的[数据存证编号关联到指定用户]接口。
6.拼接存证查看链接
数据存证成功后可以将该链接嵌入到贵司系统中，以方便贵司的客户快速跳转到e签宝的存证证明查看页面浏览存证信息。
可查看接口列表中的[拼接用于查看存证证明的跳转URL]接口。
7.查询区块链上链信息
e签宝服务端会将创建的原文存证证据点和摘要存证证据点推送上链，可通过查询区块链上链信息接口，查询区块链上链信息。
8.申请区块链互联网公证处报告
上链后，可通过申请区块链互联网公证处报告接口，申请出证。
9.核验签署文件上链信息
上链后，可通过核验签署文件上链信息接口核验上链的信息是否一致，数据是否被篡改。
我要纠错