
# 存证信息核验 - ValidateEvidence
#### 功能介绍
存证信息核验；支持使用index参数进行通用搜索，也支持指定条件file_hash、tx_id、ev_id搜索。（使用时，必须在index 和其他参数中，两者选择一个）
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
GET /v1/{project_id}/chains/{chain_id}/evidence/verification
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
| chain_id   | 是    | String | 数字资产链实例ID                     |
表2Query参数 
| 参数        | 是否必选 | 参数类型   | 描述                             |
|:---|:---|:---|:---|
| 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  |
   
