获取累计区块大小
1. 概述与典型用途
返回累计区块大小(链上数据量),按时间升序排列。
- 典型用途:监控区块链数据总量增长趋势、评估存储需求。
- 何时不要用:查每日平均区块大小用「获取平均区块大小数据」。
2. 接口与鉴权
GET /api/overview/totalblockchainsize
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
days | integer | 否 | 15 | 查询天数 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
lastUpdateSeconds | integer | 必返 | 最后更新时间 | 秒级 Unix 时间戳(10 位) |
code | integer | 必返 | 状态码(如 200) | — |
success | boolean | 必返 | 请求是否成功 | — |
message | string | 必返 | 结果消息(如 "request ok") | — |
status | string | 必返 | 状态标识(如 "1" 表示正常) | — |
data | array | 必返 | 每日累计区块大小数组,见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 统计日期 | 毫秒时间戳 |
dateDayStr | string | 必返 | 统计日期字符串,格式 yyyy-MM-dd | — |
blockchainSize | integer | 必返 | 累计区块链数据大小 | 字节 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果不是错误:无数据返回
200+data: [],属于正常响应。
最后更新于: