Uptimeify Docs

SMTP Monitor Ausfall-Historie abrufen

Gibt die Vorfälle eines einzelnen SMTP Monitors zurück (die letzten 100), inklusive berechneter Dauer.

GET /api/smtp-monitors/:smtpMonitorPublicId/incident-history

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Parameter

  • smtpMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des SMTP Monitors.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/smtp-monitors/11111111-1111-4111-8111-111111111111/incident-history" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Beispiel-Antwort

{
  "incidents": [
    {
      "id": 123,
      "type": "downtime",
      "status": "resolved",
      "startedAt": "Feb 26, 2026, 12:10:00",
      "endedAt": "Feb 26, 2026, 12:12:30",
      "duration": "2m 30s"
    }
  ],
  "total": 1
}

type spiegelt die Fehlerkategorie dieses Monitors wider; status ist active (laufend) oder resolved. Laufende Vorfälle haben ein null bei endedAt.

Häufige Fehler

  • 400 SMTP monitor public ID (UUID) required wenn :smtpMonitorPublicId ungültig ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keinen Zugriff auf den Monitor hast

Auf dieser Seite