Status
GET
/api/v1/status返回公开目标、当前状态、SLA 汇总、事件、前端外观配置、Ping 目标和最新 Agent 遥测。它是替代前端的主要入口。
查询参数
| 参数 | 必填 | 默认 | 范围 | 说明 |
|---|---|---|---|---|
days | 否 | 服务端默认值 | 1–90 | 日汇总与 SLA 展示跨度 |
lite | 否 | 0 | 0 或 1 | 1 返回更适合首屏的精简数据 |
bash
curl -fsSL 'https://YOUR-API/api/v1/status?days=30&lite=1'顶层字段
| 字段 | 说明 |
|---|---|
name | 公开站点名称 |
now | 服务端生成响应的 ISO 时间 |
days | 当前返回的日期列表 |
regions | 区域代码到显示名称的映射 |
frontend | 经过公开过滤的主题和外观设置 |
privacy | IP、端口和机房信息的公开策略 |
timezone | SLA 聚合使用的时区 |
targets[] | 目标资料、当前探测、Agent 状态和延迟来源 |
summaries[] | 每目标每日 SLA 聚合 |
incidents[] | 最近故障与恢复事件 |
ping_targets[] | 已启用的 Agent TCP Ping 目标 |
warnings[] | 非致命同步或数据警告 |
targets[] 的关键字段
目标类型和部署设置会影响字段是否存在：
id、name、group_name、type：稳定标识和分类；location、city、provider、line_type：公开展示资料；ok、checked_at、latency_ms：Cloudflare 当前探测；agent_online、last_metrics_at、agent_version：Rust Agent 状态；agent_metrics：经过公开过滤的最新系统指标；latency_sources[]：Cloudflare 与仍在 stale 窗口内的外部来源；has_nq、nq：NodeQuality 报告是否存在及更新时间；no_public_ip：启用后不公开目标 IP、端口和主动延迟数据。
不要混合状态来源
ok 表示 Cloudflare 主动探测，agent_online 表示指标 Agent 最近上报。二者应分别显示，不要用其中一个覆盖另一个。
精简模式
首屏建议请求 lite=1，详情打开后再按需读取 checks、metrics、pings 或 latency。这样可以减少移动端解析和绘图成本。
时间与排序
服务端时间可能与客户端不同。界面计算“刚刚上报”时优先使用响应中的 now 作为参考；历史数组仍应按数字时间戳显式排序，不依赖返回顺序。
隐私处理
服务端会根据部署设置掩码 IP、隐藏端口、移除 URL 凭据和内部错误细节。客户端不应尝试从其他公开字段还原这些信息，也不要缓存管理 API 数据作为公开状态替代品。