查询存证区块列表
功能介绍
查询存证区块列表
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 |