#
数据登记API调用流程
数据登记API的调用流程如下面的时序图所示:
当有企业员工操作企业系统,出现数据更新时,触发数据登记流程。
企业系统首先需要根据用户的操作类型,提取并构造出需要登记的原始数据。根据用户操作行为的不同,原始数据的类型也不同。比如如果操作行为是上传了一个文件,则对应的原始数据就是文件内容。如果操作行为是通过了一项审批,则对应的原始数据可以是一个JSON字符串,其中包括审批人、审批意见等。
构造原始数据时,需保证数据具备基本的可读性,便于在出证时,能够让司法人员快捷的识别出原始内容,能够和我方声明的知识产权关联起来。不要使用二进制编码、加密等方式处理原始数据。详情请参考哈希计算注意事项。
得到数据哈希值后,按照数据登记API的要求,使用哈希值、App ID等参数构造出请求URL,并使用App Secret生成URL的签名,将签名加入URL中,发起数据登记的请求。签名的生成方法请参考接口认证签名方法。
平台收到数据登记请求后,使用托管的企业数字身份对数据哈希值进行签名后,进行确权登记,生成数字财产DNA,返回给企业系统。数字财产DNA可看作是数字财产的唯一ID。
至此数字财产登记已经成功了。企业系统需要保存构造好的原始数据,用于以后的出证行为。对于动态拼接出的原始数据(比如JSON字符串),请务必要存入数据库留档,防止以后需要出证时,无法再拼接出同样的数据。
平台支持通过数据哈希值查询并下载证据包,因此在企业系统保存了原始数据,并保证哈希计算正确的情况下,可以不用保存DNA。企业系统也可保存DNA和登记状态等信息,便于系统管理。