查询存证列表
功能介绍
查询存证列表
URI
GET /v1/{project_id}/chains/{chain_id}/evidences
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户从IAM申请到的projectid,一般为32位字符串 最小长度:32 最大长度:64 |
chain_id |
是 |
String |
数字资产链实例ID 最小长度:32 最大长度:64 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
分页,每页大小,分页大小只支持10、20、50/页,默认显示10条/页 最小值:10 最大值:50 |
offset |
否 |
Integer |
偏移量,从第几项开始,默认值为0 最小值:0 最大值:65535 |
name |
否 |
String |
按照存证名称字段搜索,支持模糊匹配 最小长度:4 最大长度:765 |
id |
否 |
String |
按照存证名称ID搜索,精确匹配 最小长度:32 最大长度:32 |
charge_type |
否 |
String |
按照存证类型,精确匹配 最小长度:4 最大长度:64 |
begin_time |
否 |
String |
按照时间范围搜索,起始时间 (UTC时间,毫秒级),和end_time配合使用。最大时间不超过30天。 最小长度:13 最大长度:16 |
end_time |
否 |
String |
按照时间范围搜索,截止时间 (UTC时间,毫秒级),和begin_time配合使用。最大时间不超过30天 最小长度:13 最大长度:16 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total_count |
Integer |
总记录 |
evidences |
Array of Evidence objects |
存证信息列表 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
存证名称 |
ev_id |
String |
存证ID |
file_hash |
String |
存证指纹 |
charge_type |
String |
存证类型, normal:普通存证 |
create_time |
String |
创建时间 |
tx_id |
String |
交易ID |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:20 |
error_msg |
String |
错误描述 最小长度:1 最大长度:512 |
请求示例
/v1/:project_id/chains/:chain_id/evidences?begin_time=1717344000000&end_time=1719935999000&charge_type=normal&limit=10&offset=0
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
success |
400 |
Error response |