GET /history – ferrixx API

Ping-Verlauf

Gibt die letzten Ping-Ergebnisse eines konfigurierten Servers aus den Logs zurück, inkl. Zusammenfassung.

GET /v1/history ping

Parameter

Parameter	Typ	Pflicht	Beschreibung
`id`	integer	ja	Server-ID (aus /v1/servers)
`limit`	integer	nein	Anzahl Einträge (1–100, Standard: 25)

Beispiel-Request

curl -H "X-API-Key: apk_dein_key" \
     "https://api.ferrixx.de/v1/history?id=1&limit=10"

Beispiel-Antwort

{
  "success": true,
  "message": "OK",
  "data": {
    "server": {
      "id": 1,
      "name": "Google DNS",
      "host": "8.8.8.8",
      "port": 53,
      "type": "tcp"
    },
    "summary": {
      "total": 10,
      "online": 9,
      "offline": 1,
      "uptime_pct": 90.0,
      "avg_latency_ms": 12.34
    },
    "logs": [
      {
        "status": "online",
        "latency_ms": 11.2,
        "message": "TCP OK",
        "checked_at": "2026-06-01 12:00:00"
      },
      {
        "status": "offline",
        "latency_ms": null,
        "message": "Connection refused",
        "checked_at": "2026-06-01 11:55:00"
      }
    ]
  },
  "timestamp": "2026-06-01T12:00:00+00:00"
}