# 接口返回值说明

# 接口调用状态

数产开放平台API的接口调用状态在HTTP状态码中返回。所有的接口都会返回三种状态:

HTTP状态码 状态 Body内容 说明
200 调用成功 数字财产数据 登记成功,Body中为数字财产数据。详见后续数字财产数据格式
400 调用参数错误 具体的错误内容,JSON格式 企业系统调用API时传递的参数有误,具体的错误在Body中有说明。格式详见后续400错误格式
500 服务器错误 Internal Server Error 服务器错误,请稍后再试。

# 数字财产数据格式

字段名称 类型 说明
hash string 登记的哈希值
type number 数字资产类型
status number 登记状态。 8:登记完成 9:登记失败 其他:登记中
algorithm string 区块链上该记录对应数字签名的加密算法。 zkp:零知识证明 ecc:椭圆曲线签名
dna string 数字财产DNA
enterprise_public_key string 生成数字签名的企业证书公钥
sign_hash string 计算数据签名的哈希
zk_commitment string 零知识证明公开变量。 algorithm为zkp时存在
zk_proof string 零知识证明证据。 algorithm为zkp时存在
signature string ecc的数据签名。 algorithm为ecc时存在
app_id number 应用ID

# 400错误格式

字段名称 类型 说明
field_name string 导致错误的参数。详细的错误类型见后续的错误列表
message string 错误原因。详细的错误原因见后续的错误列表

# 错误列表

field_name message 说明
signature incorrect signature 签名计算错误
timestamp signature has expired 时间戳已过期。timestamp有效期为10分钟。
app_id app not found 对应的企业应用不存在。
hash hash already exists 同一个企业应用内不能重复登记。
hash hash not exist 查询的哈希值不存在。