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 nichtraw, 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:
imapPopMonitorIdmonitorlatestCheckuptimeStats,uptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
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
400Ungültige IMAP/POP Monitor Public ID (UUID)401Unauthorized403Forbidden404IMAP/POP monitor not found500Failed to fetch IMAP/POP monitor details
Häufige Fehler
400 Bad Request(invalidRequestBody) wennrangenichtday/week/month/yearist,date/startDate/endDatekein Datum ist, nur eines vonstartDate/endDatekommt,tzkeine Ganzzahl ist odergranularitywederrawnochaggregated