Öffentliche API

Alle öffentlichen Dienste, ihre Gruppen mit verdichtetem Zustand, die Tagesverfügbarkeit über höchstens 90 Tage sowie offene und behobene Vorfälle und angekündigte Wartungen.

{
  "overall": "operational",
  "page": { "title": "...", "historyDays": 90 },
  "groups": [
    {
      "id": "...",
      "name": "API",
      "icon": "code",
      "status": "operational",
      "uptimeRange": 99.98,
      "summaryOnly": false,
      "days": [ { "date": "2026-07-31", "uptime": 100 } ]
    }
  ],
  "services": [
    {
      "id": "...",
      "name": "Website",
      "groupId": null,
      "status": "operational",
      "uptimeRange": 99.96,
      "days": [ { "date": "2026-07-31", "uptime": 100 } ],
      "recent": [ { "start": "2026-07-31T11:50:00.000Z", "uptime": 100 } ]
    }
  ],
  "incidents": { "active": [], "recent": [] },
  "maintenances": { "upcoming": [], "recent": [] },
  "metrics": { "days": 90, "uptime": 99.96 },
  "updatedAt": "..."
}

Nur der Gesamtstatus und die Zähler. Klein genug für eine Ampel im eigenen Dashboard.

{
  "overall": "operational",
  "services": { "total": 8, "operational": 8, "degraded": 0, "down": 0, "maintenance": 0 },
  "activeIncidents": 0,
  "upcomingMaintenances": 1,
  "uptime": 99.96,
  "updatedAt": "..."
}

• Antworten werden 20 Sekunden zwischengespeichert. Häufiger abzufragen liefert dieselben Daten.
• null heißt unbekannt, nicht null. Ein Tag ohne Messung hat uptime: null, keine 0 und keine 100.
• metrics.days ist der tatsächlich erfasste Zeitraum und höchstens so groß wie page.historyDays. Kurz nach einer Installation ist er kleiner, statt fehlende Tage als Lücke auszuweisen.
• recent ist das 30-Minuten-Raster der letzten 24 Stunden, je Eintrag nur Rasterbeginn und Quote. Leer, wenn im ganzen Fenster nichts gemessen wurde.
• Eine Gruppe fasst mehrere Dienste zu einem Zustand zusammen: alle betriebsbereit ist operational, ein Ausfall unter mehreren ist degraded, erst alle zusammen sind down. Bei summaryOnly: true steht nur die Gruppe in der Antwort, ihre Mitglieder nicht.
• Es werden ausschließlich Dienste ausgeliefert, die ausdrücklich veröffentlicht wurden. Ziel-Adressen, Fehlertexte, Antwortzeiten und Statuscodes sind nicht Teil der Antwort.