流量

GET

/api/chart/traffic

查询流量图表数据。

如果统计数据时有下载器离线，则会影响“所有下载器总量”的显示。

journal 数据是按日结算数据，在获取数据时会使用前一天最后一次记录的总流量数据与当日最后一次记录的总流量数据求差。差的结果将作为当日结算结果。

数据范围：
startAt：会包含指代的日期的日数据
endAt：不会包含指代的日期的日数据
示例：startAt 是9号0点时间戳，endAt 是15号0点时间戳，则最终数据范围是：从 9 号 00:00:00 到 14 号 23:59:59。

如果需要 endAt 指代日期的当日数据，则应为 endAt 添加一个 86400000 毫秒的偏移到下一天。

startAt 和 endAt 如果不是一个 0 点时间戳，将被转换为其时间戳所在日的日0点时间戳。（如时间戳是 28 日的 17:23:22，则会被转换为 28 日的 00:00:00）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'http://127.0.0.1:9897/api/chart/traffic?startAt=&endAt={% mock '\''timestamp'\'' %}&downloader='

返回响应

🟢200成功

application/json

Body

示例

{"success":true,"message":null,"data":[{"timestamp":1724688000000,"dataOverallUploaded":69916632349,"dataOverallDownloaded":1005525037259},{"timestamp":1724774400000,"dataOverallUploaded":69916732349,"dataOverallDownloaded":1005526037259},{"timestamp":1724860800000,"dataOverallUploaded":69916884937,"dataOverallDownloaded":1005526580935}]}

🟠403未登录或Token错误

🟠429IP地址因频繁失败尝试而被封禁

🔴500内部服务器错误

🟠400通用参数错误

🔵303需要OOBE初始化

🟠402需要PBH Plus许可证

修改于 2025-07-18 07:28:26

趋势

查询指定 IP 的基本信息