存证使用趋势 - ShowDedicateEvidencesTrend

功能介绍

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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
  } ]
}