Skip to Content
Uptimeify Docs

Ausfall-Details abrufen

Gibt Details zu einem bestimmten Vorfall zurück.

GET /api/incidents/:incidentPublicId

Enthält neben den Incident-Basisdaten auch eine Timeline (Checks/Alert-Events) sowie optional einen Evidence-Check.

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Parameter

  • incidentPublicId (Path, required): Öffentliche UUID des Incidents.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/incidents/6bfec6f6-245a-47ce-843b-157d97d56f88" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Hinweis: evidenceCheck kann null sein. screenshotUrl ist nur gesetzt, wenn hasScreenshot true ist.

Auflösung der Timeline

timeline.outageChecks listet jeden Check zwischen der Bestätigung (confirmationAt, ausschließlich) und dem Ende des Vorfalls, fehlgeschlagene wie erfolgreiche, aufsteigend und auf 200 begrenzt; outageChecksTotal ist die volle Anzahl. Maßgeblich ist status je Eintrag: ein aggregierter Zeitraum ist failure, sobald darin ein Standort fehlgeschlagen ist.

Jeder Eintrag in outageStartedCheck, failedChecks, outageChecks und recoveryChecks trägt ein Feld resolution:

  • raw: eine einzelne Prüfung an einem einzelnen Standort. location, statusCode und errorMessage sind die Werte, die dieser Standort gemeldet hat.
  • 1min: eine Minute aus dem Monitoring-Aggregat. Sie wird verwendet, sobald ein Vorfall älter ist als die Aufbewahrungsfrist der Rohdaten (24 Stunden). location, statusCode und errorMessage sind dann null, responseTimeMs ist der Mittelwert der Minute, und zwei zusätzliche Felder nennen die Standorte dahinter: totalLocations und failedLocations.
  • 15min und 1day: ein 15-Minuten- bzw. Tagesintervall, verwendet, sobald das Minutenaggregat nicht mehr zurückreicht (ab 7 Tagen 15min, ab 30 Tagen 1day). Dieselben Felder sind null wie bei 1min, die Zähler nennen aber einzelne Standort-Checks statt Standorte: totalChecks und failedChecks.
  • Server- und DNS-Monitore (TCP, SSH, FTP, SMTP, IMAP/POP, ICMP, DNS) haben keine 15-Minuten-Stufe: 1min reicht 30 Tage zurück, ältere Vorfälle bekommen 1day-Einträge mit totalChecks und failedChecks.

Die id eines aggregierten Eintrags ist synthetisch (<resolution>-<Zeitstempel>, z. B. 1min-2026-09-01T10:00:00.000Z) und lässt sich nicht als Prüfung nachschlagen. Die vier Listen werden unabhängig voneinander aufgelöst; ein Vorfall, der eine Grenze überspannt, kann Auflösungen mischen.

Antwort (Auszug)

{
  "incident": {
    "id": 123,
    "websiteId": 101,
    "type": "downtime",
    "status": "open",
    "startedAt": "2026-02-26T12:10:00.000Z",
    "resolvedAt": null,
    "statusCode": null,
    "errorMessage": "Timeout",
    "responseTimeMs": null,
    "falseAlarmAt": null,
    "falseAlarmReason": null,
    "publicTitle": null,
    "publicStatus": "open",
    "publicResolvedAt": null
  },
  "timeline": {
    "outageStartedAt": "2026-02-26T12:08:00.000Z",
    "outageStartedCheck": {
      "id": "chk_01H...",
      "checkedAt": "2026-02-26T12:08:00.000Z",
      "status": "failure",
      "statusCode": 503,
      "errorMessage": "Timeout",
      "responseTimeMs": null,
      "location": { "id": 7, "code": "de-nbg", "name": "Nuremberg (DE)" },
      "resolution": "raw"
    },
    "confirmationAt": "2026-02-26T12:10:00.000Z",
    "failedChecks": [
      {
        "id": "1min-2026-02-26T12:09:00.000Z",
        "checkedAt": "2026-02-26T12:09:00.000Z",
        "status": "failure",
        "statusCode": null,
        "errorMessage": null,
        "responseTimeMs": 246,
        "location": null,
        "resolution": "1min",
        "totalLocations": 3,
        "failedLocations": 2
      }
    ],
    "failedChecksTotal": 2,
    "alertEvents": [
      {
        "id": 987,
        "sentAt": "2026-02-26T12:11:00.000Z",
        "type": "email",
        "status": "sent",
        "channelName": "Ops Email",
        "errorMessage": null
      }
    ],
    "recoveryChecks": [],
    "recoveryChecksTotal": 0,
    "outageChecks": [],
    "outageChecksTotal": 0
  },
  "evidenceCheck": {
    "id": "chk_01H...",
    "checkedAt": "2026-02-26T12:08:00.000Z",
    "diagnostics": null,
    "hasScreenshot": false,
    "screenshotUrl": null
  }
}

Fehlalarm-Markierung

Ein Vorfall kann als Fehlalarm markiert werden (POST /api/incidents/{id}/false-alarm). Zwei Felder auf incident geben diese Markierung wieder, nur lesend:

FeldTypBedeutung
falseAlarmAtstring | nullWann markiert wurde, ISO 8601. null heißt: nicht markiert.
falseAlarmReasonstring | nullDer beim Markieren angegebene freie Grund, oder null.

Die Markierung ist rücknehmbar, falseAlarmAt kann also wieder null werden. Sie ändert den status nicht: ein als Fehlalarm markierter Vorfall ist trotzdem als Alarm hinausgegangen, und genau das hält die Markierung fest.

Wer markiert hat, steht nicht in der Antwort.

Markieren und Zurücknehmen folgen derselben Schreibregel wie jede andere Änderung am Vorfall: im Kundenbereich des Vorfalls muss jede verknüpfte Statusseite es erlauben (organisationsweit admin oder editor; kundengebundene Aufrufer, auch mit der Rolle readonly, auf self_service-Seiten oder auf managed-Seiten mit der Ausnahme canEditManaged des Kunden, sonst 403 managed_by_organization). Ein Vorfall ohne verknüpfte Seite braucht admin oder editor.

Statusseiten-Verknüpfungen

statusPageLinks (seit 27. Oktober 2026) listet die Statusseiten und optional Komponenten, mit denen der Vorfall über Manuellen Vorfall anlegen oder Vorfall aktualisieren verknüpft ist: statusPageId, statusPagePublicId, statusPageName, componentId (null = seitenweit), componentPublicId, componentName und impact. Leer bei einem Vorfall, der nur über seinen Kunden oder Monitor erscheint. Einen manuellen Vorfall ohne Kunden lesen nur organisationsweite Rollen; ein kundengebundenes Login oder Token bekommt 404.

publicTitle, publicStatus und publicResolvedAt (seit 28. Oktober 2026) beschreiben den Vorfall, wie Statusseiten ihn zeigen. publicTitle ist der mit Vorfall aktualisieren gesetzte Titel für die Seiten oder null (die Seiten zeigen dann title). publicStatus ist open oder resolved; bei einem Monitor-Vorfall setzen ihn Timeline-Updates unabhängig von status, sonst folgt er status. publicResolvedAt ist der Zeitpunkt, zu dem er auf den Seiten behoben wurde (ISO 8601).

postmortem (seit 28. Oktober 2026) ist die öffentliche Nachbetrachtung des Vorfalls, oder null, wenn keine geschrieben wurde: body (Markdown), publishedAt (null = Entwurf, nur im Statusseiten-Modul sichtbar) und updatedAt. Geschrieben wird sie mit Postmortem speichern, veröffentlicht mit Postmortem veröffentlichen.

Häufige Fehler

  • 400 Incident public ID (UUID) required wenn :incidentPublicId ungültig ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn der Incident existiert, du aber keinen Zugriff hast
  • 404 Incident not found wenn der Incident nicht existiert

Auf dieser Seite