查询存证区块列表 - ListDedicateEvidenceBlocks
功能介绍
查询存证区块列表
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/chains/{chain_id}/evidence/blocks
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户从IAM申请到的projectid，一般为32位字符串 |
chain_id | 是 | String | 数字资产链实例ID |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
limit | 否 | Integer | 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页 |
offset | 否 | Integer | 偏移量，从第几项开始,默认值为0 |
begin_time | 否 | String | 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。 |
end_time | 否 | String | 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
block_id | 否 | Integer | 区块高度值 |
X-Auth-Token | 是 | String | 从IAM服务获取的用户Token |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
total_count | Integer | 存证区块总数 |
evidence_blocks | Array of EvidenceBlockInfo objects | 存证区块信息列表 |
参数 | 参数类型 | 描述 |
|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
请求示例
无
响应示例
无
状态码
状态码 | 描述 |
|---|---|
200 | success |
400 | Error response |
