GET /uptime – ferrixx API

Uptime-Statistik

Gibt Uptime-Prozentsatz und Durchschnitts-Latenz für alle oder einen bestimmten Server zurück, berechnet aus den Ping-Logs.

GET /v1/uptime ping

Parameter

Parameter	Typ	Pflicht	Beschreibung
`id`	integer	nein	Server-ID – ohne Angabe werden alle aktiven Server zurückgegeben
`hours`	integer	nein	Zeitraum in Stunden (1–168, Standard: 24). 168 = 7 Tage

Beispiel-Requests

# Alle Server – letzte 24 Stunden
curl -H "X-API-Key: apk_dein_key" https://api.ferrixx.de/v1/uptime

# Server #1 – letzte 7 Tage
curl -H "X-API-Key: apk_dein_key" "https://api.ferrixx.de/v1/uptime?id=1&hours=168"

Beispiel-Antwort

{
  "success": true,
  "message": "OK",
  "data": {
    "period_hours": 24,
    "servers": [
      {
        "id": 1,
        "name": "Google DNS",
        "host": "8.8.8.8",
        "port": 53,
        "type": "tcp",
        "checks": 48,
        "online": 47,
        "offline": 1,
        "uptime_pct": 97.92,
        "avg_latency_ms": 11.5
      },
      {
        "id": 2,
        "name": "Cloudflare DNS",
        "host": "1.1.1.1",
        "port": 53,
        "type": "tcp",
        "checks": 48,
        "online": 48,
        "offline": 0,
        "uptime_pct": 100.0,
        "avg_latency_ms": 9.8
      }
    ]
  },
  "timestamp": "2026-06-01T12:00:00+00:00"
}

Hinweise

uptime_pct ist null wenn im gewählten Zeitraum keine Checks vorhanden sind. Die Berechnung basiert ausschließlich auf tatsächlich gespeicherten Ping-Logs – je häufiger Server über das CP oder die API gepingt werden, desto genauer die Statistik.