
# 查询存证区块列表 - ListDedicateEvidenceBlocks
#### 功能介绍
查询存证区块列表
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
GET /v1/{project_id}/chains/{chain_id}/evidence/blocks
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
| chain_id   | 是    | String | 数字资产链实例ID                     |
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                   |
|:---|:---|:---|:---|
| limit      | 否    | Integer | 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页                  |
| offset     | 否    | Integer | 偏移量，从第几项开始,默认值为0                                     |
| begin_time | 否    | String  | 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。  |
| end_time   | 否    | String  | 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型    | 描述               |
|:---|:---|:---|:---|
| block_id     | 否    | Integer | 区块高度值            |
| X-Auth-Token | 是    | String  | 从IAM服务获取的用户Token |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数              | 参数类型                                                                                          | 描述       |
|:---|:---|:---|
| total_count     | Integer                                                                                       | 存证区块总数   |
| evidence_blocks | Array of [EvidenceBlockInfo] objects | 存证区块信息列表 |
   
 表5EvidenceBlockInfo 
| 参数            | 参数类型    | 描述                                   |
|:---|:---|:---|
| name          | String  | 存证名称                                 |
| ev_id         | String  | 存证ID                                 |
| file_hash     | String  | 文件内容Hash, 即存证指纹                      |
| block_id      | Integer | 区块高度                                 |
| create_time   | String  | 创建时间,单位:毫秒                           |
| tx_id         | String  | 交易ID                                 |
| platform_name | String  | 平台名称，用户定义的平台名称                       |
| data_type     | Integer | 存证的文件类型，1:文件类型2:图片类型3:视频类型4:音频类型5:其他 |
| user_addr     | String  | 用户地址，基于用户证书生成的公钥                     |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
无
#### 响应示例
无
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | success        |
| 400 | Error response |
   
