IMAP/POP Monitor Check Historie abrufen
Gibt die letzten Check-Ergebnisse für den IMAP/POP Monitor zurück.
GET /api/imap-pop-monitors/:imapPopMonitorPublicId/check-history
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
imapPopMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des IMAP/POP Monitors.
Query Parameter
page(number, optional): Seite (Default:1). Eine Seite zählt Prüfzyklen, nicht Zeilen: ein Zyklus hat eine Zeile je Standort.limit(number, optional): Zyklen pro Seite (Default:10; Max100). Beiformat=csvoderdownload=1gelten die Export-Defaults (Default10000, Max50000Zeilen).status(string, optional):successoderfailure(failurematcht auchtimeout). Bei Minutenzeilen: kein Standort fehlgeschlagen bzw. mindestens einer.minMs/maxMs(number, optional): Filter nach Response-Time-Bereich (timingTotal; bei Minutenzeilen der Minutendurchschnitt).from/to(ISO-Datumsstring, optional): Filter nachcheckedAt-Bereich.format(string, optional):json(Default) odercsv.download(string, optional):1erzwingt einen Attachment-Download,0(Default) liefert die Seite.
cURL
curl "https://YOUR_DOMAIN/api/imap-pop-monitors/44444444-4444-4444-8444-444444444444/check-history?page=1&limit=10" \
-H "Authorization: Bearer $TOKEN"Response
{
"data": [
{
"id": "33c53ac4-a2bc-475c-a904-8d3d6aab2979",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-10-01T05:40:55.690Z",
"responseTimeMs": 29,
"location": { "name": "Paris (FR)", "code": "par" },
"resolution": "raw"
},
{
"id": "1min-2026-09-30T15:55:00.000Z",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-09-30T15:55:00.000Z",
"responseTimeMs": 54,
"location": null,
"resolution": "1min",
"totalLocations": 2,
"failedLocations": 0
}
],
"total": 864,
"page": 17,
"pageCount": 87,
"resolution": "mixed",
"rawWindowFrom": "2026-09-30T16:00:00.000Z"
}resolutionje Zeile:rawist eine einzelne Prüfung mit Standort und Fehlermeldung;1minist eine Minute über alle Standorte, ohne Standort und Fehlermeldung, dafür mittotalLocationsundfailedLocations.resolutionder Seite:raw,1minodermixed(die Seite liegt über der Grenze).rawWindowFrom: ab hier gibt es einzelne Prüfungen; ältere Zeilen sind Minutenzeilen.
Bei format=csv (oder download=1) ist die Response ein text/csv-Attachment (bzw. application/json bei format=json&download=1) anstelle der paginierten JSON-Antwort oben. CSV-Spalten: checkedAt,status,responseTimeMs,location,errorMessage,resolution.
Aufbewahrung
Einzelne Prüfungen mit Standort und Fehlermeldung bleiben 24 Stunden erhalten. Ältere Einträge kommen aus den Minutenwerten (30 Tage), eine Zeile je Minute ohne Standort und Fehlermeldung. Tageswerte (24 Monate) stehen in den Monitor-Details.
Errors
400IMAP/POP Monitor Public ID (UUID) erforderlich401Unauthorized403Forbidden404IMAP/POP monitor not found
Häufige Fehler
400 Bad Request(invalidRequestBody) wenn ein Query-Parameter ungültig ist:page/limitkeine positive Ganzzahl,formatwederjsonnochcsv,downloadweder0noch1, oder ein unbekannter Wert instatus,minMsodermaxMs400 Bad Request(invalidDateRange) wennfromodertokein Datum ist
IMAP/POP Monitor Alert-Historie abrufen
Gibt die Benachrichtigungs-/Eskalationsversuche (Alert-Historie) für Vorfälle eines IMAP/POP Monitors zurück.
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.).