查询存证列表 - ListDedicateEvidences
功能介绍
查询存证列表
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/chains/{chain_id}/evidences
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 租户从IAM申请到的projectid，一般为32位字符串 |
| chain_id | 是 | String | 数字资产链实例ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页 |
| offset | 否 | Integer | 偏移量，从第几项开始,默认值为0 |
| name | 否 | String | 按照存证名称字段搜索，支持模糊匹配 |
| id | 否 | String | 按照存证名称ID搜索，精确匹配 |
| charge_type | 否 | String | 存证类型, normal:普通存证 |
| begin_time | 否 | String | 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。 |
| end_time | 否 | String | 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 错误码 |
| error_msg | String | 错误描述 |
请求示例
/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 |
