Checks

GET/api/v1/checks

Liest Verfügbarkeitsaufzeichnungen, Tagespunkte und die passende Agent-Online-Serie für ein Ziel. Geeignet für SLA-Gitter, Latenzlinien und Ausfall-Zeitlinien.

Query-Parameter

Parameter	Pflicht	Standard	Bereich	Zweck
target_id	ja	—	gültige öffentliche Ziel-ID	Ziel
hours	nein	72	1–720	Historienfenster, max. 30 Tage
limit	nein	864	Deckel 12000, deployment-einstellbar 100–20000	max. Check-Punkte

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

Antwortstruktur

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

Feld	Zweck
checks[]	Cloudflare-Checkpunkte im Fenster, neueste zuerst
daily_points[]	aus Buckets berechnete Tagesdaten
agent_series[]	Online-Historie des Agents; nicht Cloudflare-Checks
source	aktuelle Historien-Speicherquelle

Fehlendes target_id liefert HTTP 400. Nicht existierende, deaktivierte oder adressverborgene Ziele können leere Historie liefern; aus der Status-Zielliste und den Privacy-Feldern urteilen, nicht auf die Admin-API zurückfallen.

Chart-Hinweise

1. Für Liniendiagramme kopieren und nach checked_at aufsteigend sortieren.
2. Kein 0 ms für ok = false-Punkte faken.
3. Beim Zoom-Reset die echten ersten/letzten Zeitstempel wiederherstellen.
4. Mit weniger als zwei Punkten einen Einzelpunkt-Zustand statt gestreckter Tendenz zeigen.
5. Getrennte Legenden und Labels für Cloudflare-Checks vs. agent_series.

Cache

Normalisierte target_id, hours und limit bilden den Cache-Key. Standard-Cache ~60 s, einstellbar 0-300 s; die Antwort trägt X-NIE-SLA-Cache: hit|miss und behält X-NStatus-Cache während v1. Keine bedeutungslosen Parameter hinzufügen.