文档首页/ 数字资产链 DAC/ API参考/ API/ 可信存证（专享版）/ 存证管理/ 存证使用趋势
更新时间：2025-08-04 GMT+08:00
查看PDF
分享

存证使用趋势

功能介绍

时间范围内存证使用量趋势

URI

GET /v1/{project_id}/chains/{chain_id}/evidences/trend

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户从IAM申请到的projectid，一般为32位字符串

chain_id

是

String

数字资产链实例ID
表2 Query参数

参数

是否必选

参数类型

描述

charge_type

是

String

存证类型， 取值normal，表示普通存证

time_mode

是

String

时间模式，取值支持hour;day;week;month。hour返回60个点；day返回24个点；week返回个7点；month返回30个点；

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

usages

Array of UsageTrendElement objects

使用量趋势

chain_id

String

数字资产链ID

chain_name

String

数字资产链名称
表5 UsageTrendElement

参数

参数类型

描述

t

String

时间戳，（UTC时间，毫秒级)

v

Integer

使用量

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

/v1/:project_id/chains/:chain_id/evidences/trend?charge_type=normal&time_mode=hour

响应示例

状态码：200

evidence usage trend

{
  "chain_id" : "",
  "chain_name" : "",
  "usages" : [ {
    "v" : 0,
    "t" : 1719887305
  }, {
    "v" : 0,
    "t" : 1719887425
  }, {
    "v" : 0,
    "t" : 1719887545
  }, {
    "v" : 0,
    "t" : 1719887665
  }, {
    "v" : 0,
    "t" : 1719887785
  }, {
    "v" : 0,
    "t" : 1719887905
  }, {
    "v" : 0,
    "t" : 1719888025
  }, {
    "v" : 0,
    "t" : 1719888145
  }, {
    "v" : 0,
    "t" : 1719888265
  }, {
    "v" : 0,
    "t" : 1719888385
  }, {
    "v" : 0,
    "t" : 1719888505
  }, {
    "v" : 0,
    "t" : 1719888625
  }, {
    "v" : 0,
    "t" : 1719888745
  }, {
    "v" : 0,
    "t" : 1719888865
  }, {
    "v" : 0,
    "t" : 1719888985
  }, {
    "v" : 0,
    "t" : 1719889105
  }, {
    "v" : 0,
    "t" : 1719889225
  }, {
    "v" : 0,
    "t" : 1719889345
  }, {
    "v" : 0,
    "t" : 1719889465
  }, {
    "v" : 0,
    "t" : 1719889585
  }, {
    "v" : 0,
    "t" : 1719889705
  }, {
    "v" : 0,
    "t" : 1719889825
  }, {
    "v" : 0,
    "t" : 1719889945
  }, {
    "v" : 0,
    "t" : 1719890065
  }, {
    "v" : 0,
    "t" : 1719890185
  }, {
    "v" : 0,
    "t" : 1719890305
  }, {
    "v" : 0,
    "t" : 1719890425
  }, {
    "v" : 0,
    "t" : 1719890545
  }, {
    "v" : 0,
    "t" : 1719890665
  }, {
    "v" : 0,
    "t" : 1719890785
  } ]
}

状态码

状态码

描述

200

evidence usage trend

400

Error response
父主题： 存证管理

相关文档