跳到主要内容

统计 API

获取系统统计

GET /api/v1/stats

所需权限:dashboard.view。该接口不分页,成功响应状态码为 200 OK

成功响应:

{
"total_devices": 24,
"unreachable_devices": 2,
"failed_backups_24h": 1
}

字段说明:

字段类型统计口径
total_devicesinteger系统中的设备总数
unreachable_devicesintegerreachability_status=false 的设备数;尚未检查、状态为 null 的设备不计入
failed_backups_24hinteger最近 24 小时内备份记录状态为失败的记录数,按备份开始时间统计

当前实现返回系统级汇总,不会根据 API Key 用户的设备组范围过滤统计结果。需要按设备组统计时,请先调用设备列表接口并在调用方自行聚合。