更新时间:2024-07-15 GMT+08:00
分享

存证使用趋势

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

最小长度:32

最大长度:64

chain_id

String

数字资产链实例ID

最小长度:32

最大长度:64

表2 Query参数

参数

是否必选

参数类型

描述

charge_type

String

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

最小长度:1

最大长度:64

time_mode

String

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

最小长度:3

最大长度:16

请求参数

表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

错误码

最小长度:1

最大长度:20

error_msg

String

错误描述

最小长度:1

最大长度:512

请求示例

/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

相关文档