Checks

GET/api/v1/checks

读取单个目标的可用性记录、每日点和对应 Agent 在线序列。适合 SLA 日格、延迟折线和故障时间轴。

查询参数

参数	必填	默认	范围	说明
target_id	是	—	有效公开目标 ID	目标标识
hours	否	72	1–720	历史窗口，最大 30 天
limit	否	864	受部署上限约束	最大检查点数

curl -fsSL 'https://YOUR-API/api/v1/checks?target_id=vps-a&hours=72&limit=864'

响应结构

{
  "ok": true,
  "source": "d1-check-buckets",
  "checks": [],
  "daily_points": [],
  "agent_series": []
}

字段	说明
checks[]	过滤到时间窗口、按新到旧返回的 Cloudflare 检查点
daily_points[]	从检查桶计算的日级展示数据
agent_series[]	对应 Agent 的在线历史，不等同于 Cloudflare 检查
source	当前历史存储来源

绘图建议

1. 收到数据后按 checked_at 升序复制一份用于折线图；
2. ok = false 的点不要伪造延迟为 0；
3. 缩放重置时将坐标范围设回实际首尾时间戳；
4. 数据不足两个点时显示单点状态，不拉伸成连续趋势；
5. Cloudflare 检查与 agent_series 使用不同图例和状态说明。

缓存

服务端会把规范化后的 target_id、hours 和 limit 纳入缓存键。相同查询通常会命中短缓存。前端不应通过加入无意义参数绕过缓存。