数字资产保护平台
Powered by
Powered by
#
接口返回值说明
#
接口调用状态
数产开放平台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
查询的哈希值不存在。