# 基本对接流程

实现企业内部系统自动化登记的基本流程如下图所示。

graph TD
    ss((开始))
    ss --> s1[注册企业账号]
    s1 --> s2[通过企业认证]
    s2 --> s3[创建企业应用]
    s3 --> s4[获取App ID和App Secret]
    s4 --> s5[API调用代码开发]
    s5 --> s6[系统上线]
    s6 --> se((结束))

# 企业注册和认证

如果使用的是数产平台的SaaS服务,首先需要企业在平台完成注册,提交企业基本资料,并完成企业身份的认证。

如果使用的是企业内部部署的数产服务基座,则可以跳过注册认证的步骤,直接登录基座,开始创建企业应用。

# 创建企业应用

API对接通过平台内的 “企业应用” 功能实现。针对一个企业内部系统,开发者首先需要在平台中新建一个与之对应的 “企业应用” 。平台会为每个企业应用生成一组唯一的App ID和App Secret,用于调用API时的身份认证。当企业内有多个系统需要对接时,可以创建多个与之对应的企业应用,以实现数据分离,方便管理。 详细操作流程可参考创建企业应用

# 开发

获取到App ID和App Secret后,就可以进行企业内部系统的开发了。开发者需要识别内部系统中所有涉及到数据变化的行为(比如上传文件,或者是增加一条评审意见),并在对应的位置增加调用平台API的代码,实现数据存证的功能。企业应用中的实现逻辑可参考数据登记API调用流程

由于平台只获取原始数据的哈希值,因此需要在企业系统内部做好原始数据的备份留档,尤其是对于粒度较小的数据登记。如果原始数据丢失,会导致最后出证时无法提供有效的原始数据,造成证据链条不完整,导致证据的失效。

数产平台对如何组装原始数据并计算哈希值没有硬性要求,但是在司法实践中,为了便于法庭快速确认原始文件证明的有效性,最好保持用于计算哈希值的数据的可读性。详情请参考哈希计算注意事项,请务必保证按照其中的要求完成哈希计算正确性的验证。

数产平台提供了多种语言的SDK工具包,实现了基本的身份认证、哈希计算和API调用的代码。推荐开发者根据自己的系统的语言,在SDK的基础上进行开发,可极大简化开发步骤:

如果数产平台还未提供对应的SDK。开发者可参考API详细说明文档,自行编写代码,通过HTTP请求完成系统的对接。

# 部署上线

在开发完成并测试通过后,就可以正式上线,开始使用自动化的数据确权登记了。

# 法庭出证

如果企业遇到了外部的侵权行为,需要对外进行举证的话,可以从企业内部系统中拿到原始的数据,并且在数产平台/基座中搜索到对应的确权记录,并生成产权证明文件。详情可参考生成产权证明文件