统计 API
获取系统统计
GET /api/v1/stats
所需权限:dashboard.view。该接口不分页,成功响应状态码为 200 OK。
成功响应:
{
"total_devices": 24,
"unreachable_devices": 2,
"failed_backups_24h": 1
}
字段说明:
| 字段 | 类型 | 统计口径 |
|---|---|---|
total_devices | integer | 系统中的设备总数 |
unreachable_devices | integer | reachability_status=false 的设备数;尚未检查、状态为 null 的设备不计入 |
failed_backups_24h | integer | 最近 24 小时内备份记录状态为失败的记录数,按备份开始时间统计 |
当前实现返回系统级汇总,不会根据 API Key 用户的设备组范围过滤统计结果。需要按设备组统计时,请先调用设备列表接口并在调用方自行聚合。