Status
/api/v1/statusLiefert öffentliche Ziele, aktuellen Zustand, SLA-Zusammenfassungen, Incidents, Frontend-Aussehen, Ping-Ziele und die neueste Agent-Telemetrie. Es ist der Haupteinstiegspunkt für alternative Frontends.
Query-Parameter
| Parameter | Pflicht | Standard | Bereich | Zweck |
|---|---|---|---|---|
days | nein | Server-Standard | 1–90 | Tageszusammenfassung und SLA-Spanne |
lite | nein | 0 | 0 oder 1 | 1 liefert first-screen-freundliche Daten |
curl -fsSL 'https://YOUR-API/api/v1/status?days=30&lite=1'Top-Level-Felder
| Feld | Zweck |
|---|---|
name | öffentlicher Site-Name |
now | Server-ISO-Zeit |
days | Datumsliste der Antwort |
regions | Regionscode zu Anzeigename |
region_proxy_enabled | regionales Durable-Object-Binding |
frontend_theme | Name des integrierten Themes |
frontend | öffentlich gefilterte Theme/Erscheinungs-Einstellungen |
traffic | Beschreibung der aktuellen Traffic-Periode |
privacy | öffentliche Policy für IPs, Ports, Datacenter-Info |
storage | Speicherfähigkeiten und Cache-TTLs |
timezone | SLA-Aggregations-Zeitzone |
targets[] | Zielprofile, aktuelle Checks, Agent-Zustand, Latenzquellen |
summaries[] | tägliche SLA-Aggregation je Ziel |
incidents[] | jüngste Ausfall-/Wiederherstellungs-Ereignisse |
ping_targets[] | aktivierte Agent-TCP-Ping-Ziele |
warnings[] | nicht fatale Sync- oder Datenwarnungen |
targets[]-Schlüsselfelder
id,name,group_name,type: stabile Identität und Klassifikation.location,city,provider,line_type: öffentliches Profil.ok,checked_at,latency_ms: aktueller Cloudflare-Check.agent_online,last_metrics_at,agent_version: Rust-Agent-Zustand.agent_metrics: öffentlich gefilterte neueste Systemmetriken.latency_sources[]: Cloudflare- und externe Quellen im Frischefenster.has_nq,nq: ob ein NodeQuality-Bericht existiert und wann er aktualisiert wurde.unlock: entschärfte Dienstergebnisse einer manuellen IPv4-Unlock-Prüfung.no_public_ip: verbirgt Ziel-IP, Port und aktive Latenzdaten.
ok ist der aktive Cloudflare-Check; agent_online sagt, ob der Metrik-Agent zuletzt gemeldet hat. Beides getrennt anzeigen; nicht das eine das andere überschreiben lassen.
agent_metrics.vps_info.total_disk_gb ist die Kapazität des Root-Dateisystems, keine Summe der Mounts; Bind-Mounts desselben Geräts werden nicht doppelt gezählt.
Lite-Modus
lite=1 für den ersten Paint anfordern, dann Checks, Metrics, Pings oder Latency beim Öffnen der Details laden. Lite behält Ziele, Zusammenfassungen, Incidents, Privacy, Aussehen und Warnungen, entfernt aber Tagesdetails der Ziele und schwere Felder wie agent_metrics.pings.
Zeit und Reihenfolge
Serverzeit kann von der Client-Zeit abweichen. now als Referenz für „gerade gemeldet" verwenden; Historie-Arrays explizit nach numerischem Zeitstempel sortieren.
Datenschutz
Der Server maskiert IPs, verbirgt Ports, entfernt URL-Zugangsdaten und interne Fehlerdetails gemäß Deployment-Einstellungen. Versuchen Sie nicht, diese aus anderen öffentlichen Feldern zu rekonstruieren, und cachen Sie keine Admin-API-Daten als Status-Ersatz.
Bei TCP-Zielen mit no_public_ip sind Cloudflare-Checks und externe Latenz verborgen, status_source wird Agent, und ok/checked_at/latency_ms können null sein. Nur den Agent-Online-Zustand anzeigen; null nicht als Ausfall interpretieren.
Cache und Warnungen
Der Standard-Status-Cache beträgt ~20 s, einstellbar 0-300 s. Die öffentliche v1-API kann ihn nicht mit fresh=1 umgehen; nur interne Status-Anfragen mit gültiger Admin-Session erzwingen ein Refresh. warnings[] bedeutet degradierte optionale Quellen; die Hauptziele rendern weiterhin.