文档首页/ 数字资产链 DAC/ API参考/ API/ 可信存证（专享版）/ 存证核验/ 存证信息核验
更新时间：2024-07-15 GMT+08:00
查看PDF
分享

存证信息核验

功能介绍

存证信息核验；支持使用index参数进行通用搜索，也支持指定条件file_hash、tx_id、ev_id搜索。（使用时，必须在index 和其他参数中，两者选择一个）

URI

GET /v1/{project_id}/chains/{chain_id}/evidence/verification

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户从IAM申请到的projectid，一般为32位字符串

最小长度：32

最大长度：64

chain_id

是

String

数字资产链实例ID

最小长度：32

最大长度：64
表2 Query参数

参数

是否必选

参数类型

描述

index

否

String

通用搜索条件：取值为存证ID、证据指纹、交易ID中任意1个值

最小长度：32

最大长度：64

file_hash

否

String

证据指纹搜索条件：取值为证据指纹

最小长度：32

最大长度：64

tx_id

否

String

交易ID搜索条件：取值为交易ID

最小长度：32

最大长度：64

ev_id

否

String

存证ID搜索条件：取值为存证ID

最小长度：32

最大长度：64

请求参数

无

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

name

String

存证名称

最小长度：4

最大长度：255

ev_id

String

存证ID

最小长度：32

最大长度：64

file_hash

String

文件内容Hash, 即存证指纹

最小长度：32

最大长度：64

block_hash

String

区块哈希

最小长度：32

最大长度：64

block_height

Integer

区块高度

最小值：0

最大值：9223372036854775807

create_time

String

创建时间,单位:毫秒

最小长度：13

最大长度：15

tx_id

String

交易ID

最小长度：32

最大长度：64

platform_name

String

平台名称，用户定义的平台名称

最小长度：0

最大长度：255

data_type

Integer

存证的文件类型，0:文件类型1:图片类型2:视频类型3:音频类型4:其他

枚举值：

  • 1

  • 2

  • 3

  • 4

  • 5

user_addr

String

用户地址，基于用户证书生成的公钥

最小长度：32

最大长度：64

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

状态码： 500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：1

最大长度：20

error_msg

String

错误描述

最小长度：1

最大长度：512

请求示例

无

响应示例

状态码： 200

verify evidence

{
  "name" : "test01",
  "ev_id" : "7484b9b5b4bc11ed87c64a2b0e716f7e",
  "file_hash" : "61135423d6f938fb46932ba2eb2852271e6a3ee20b8c7448e547b96ad72def84",
  "block_hash" : "rPF6EDUVf+lA1ZoCxPyEPWHO7YiMh+YKATstQqumQV0=",
  "block_height" : 1556,
  "create_time" : "1671517527492",
  "tx_id" : "541443bb866c8af826fcdef85d17a17f0bcc4da6373a32e0c5a8a0da9958f71a",
  "platform_name" : "test",
  "data_type" : 1,
  "user_addr" : "0e4f922e897d977d2c0726ea64ef0852653505f0"
}

状态码： 400

Error response

  • {
  "error_code" : "TDE.40000400",
  "error_msg" : "InvokeReq params invalid"
}
  • {
  "error_code" : "TDE.40010404",
  "error_msg" : "resource not found"
}

状态码： 500

Error response

{
  "error_code" : "TDE.50010008",
  "error_msg" : "Internal error"
}

状态码

状态码

描述

200

verify evidence

400

Error response

500

Error response
父主题： 存证核验

相关文档