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

存证信息核验 - ValidateEvidence

功能介绍

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

chain_id

是

String

数字资产链实例ID

表2 Query参数

参数

是否必选

参数类型

描述

index

否

String

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

file_hash

否

String

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

tx_id

否

String

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

ev_id

否

String

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

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

name

String

存证名称

ev_id

String

存证ID

file_hash

String

文件内容Hash, 即存证指纹

block_hash

String

区块哈希

block_height

Integer

区块高度

create_time

String

创建时间,单位:毫秒

tx_id

String

交易ID

platform_name

String

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

data_type

Integer

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

user_addr

String

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

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

无

响应示例

状态码：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

父主题：存证核验

相关文档