Skip to Content
Uptimeify Docs

IMAP/POP Monitor Details abrufen

Konsolidierter Endpunkt, der das IMAP/POP Monitor Detailseiten-Payload in einem Call zurückgibt (latest check, uptime stats, incidents, alert history, maintenance windows, chart data, etc.).

GET /api/imap-pop-monitors/:imapPopMonitorPublicId/details

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Parameter

  • imapPopMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des IMAP/POP Monitors.
  • range (Query, optional): day | week | month | year (Default: day).
  • date (Query, optional): Referenzdatum als ISO String.
  • startDate (Query, optional): Override Startdatum als ISO String.
  • endDate (Query, optional): Override Enddatum als ISO String.
  • granularity (Query, optional): Wenn gesetzt und nicht raw, kann das Backend Chart-Daten aggregieren.

cURL

curl -X GET "https://YOUR_DOMAIN/api/imap-pop-monitors/66666666-6666-4666-8666-666666666666/details?range=day" \
  -H "Authorization: Bearer $TOKEN"

Response

Die Response ist ein großes Objekt. Wichtige Top-Level Felder:

  • imapPopMonitorId
  • monitor
  • latestCheck
  • uptimeStats, uptimeStatsMeta
  • monitoringData
  • incidents
  • alerts
  • testResultLog
  • maintenance

Beispiel (gekürzt):

{
  "imapPopMonitorId": 500,
  "monitor": { "id": 500, "hostname": "mail.deinkunde.com", "status": "active" },
  "latestCheck": { "id": 123, "status": "success", "checkedAt": "2026-02-26T12:00:00.000Z" },
  "uptimeStats": {
    "day": "100.00",
    "month": "100.00",
    "year": "100.00",
    "dayAvgResponse": 142,
    "monthAvgResponse": 150,
    "yearAvgResponse": 160
  },
  "maintenance": {
    "inMaintenance": false,
    "activeWindows": [],
    "allWindows": []
  }
}

Aufbewahrung

Einzelne Prüfungen bleiben 24 Stunden erhalten, Minutenwerte 30 Tage und Tageswerte 24 Monate; ein Zeitraum, der älter als 30 Tage ist, liefert einen Punkt pro Tag. Hat der Monitor in den letzten 24 Stunden nicht geprüft, beschreibt latestCheck seine letzte Minute aus dem Aggregat: id beginnt mit 1min-, resolution ist 1min, locationId und errorMessage sind null.

Errors

  • 400 Ungültige IMAP/POP Monitor Public ID (UUID)
  • 401 Unauthorized
  • 403 Forbidden
  • 404 IMAP/POP monitor not found
  • 500 Failed to fetch IMAP/POP monitor details

Häufige Fehler

  • 400 Bad Request (invalidRequestBody) wenn range nicht day/week/month/year ist, date/startDate/endDate kein Datum ist, nur eines von startDate/endDate kommt, tz keine Ganzzahl ist oder granularity weder raw noch aggregated

Auf dieser Seite