IMAP/POP Monitor Ausfall-Historie abrufen
Gibt die Vorfälle eines einzelnen IMAP/POP Monitors zurück (die letzten 100), inklusive berechneter Dauer.
GET /api/imap-pop-monitors/:imapPopMonitorPublicId/incident-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).limit(number, optional): Einträge pro Seite (Default:25; Max100). Wird beiformat=csvoderdownload=1durch die Export-Defaults ersetzt (Default10000, Max50000).status(string, optional):open,acknowledgedoderresolved.type(string, optional):downtime,http_status,ssl_expiry,ssl_critical,ssl_warning,response_time,dnsbl,domain_expiry_warning,criticaloderinconclusive.from/to(ISO-Datumsstring, optional): Filter nachstartedAt-Bereich.format(string, optional):json(Default) odercsv.download(string, optional):1erzwingt einen Attachment-Download,0(Default) liefert die Seite.envelope(string, optional):itemsliefert die Antwort als{ items, total, page, perPage }. Ab 18.01.2027 Standard.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/imap-pop-monitors/11111111-1111-4111-8111-111111111111/incident-history?envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Beispiel-Antwort
{
"items": [
{
"id": 123,
"publicId": "55555555-5555-4555-8555-555555555555",
"type": "downtime",
"status": "resolved",
"startedAt": "2026-02-26T12:10:00.000Z",
"endedAt": "2026-02-26T12:12:30.000Z",
"durationMs": 150000,
"statusCode": null,
"errorMessage": "connect ETIMEDOUT",
"details": "connect ETIMEDOUT",
"isOngoing": false
}
],
"total": 1,
"page": 1,
"perPage": 25
}Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage } (perPage ist das limit). Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form { data, total, page, pageCount }; sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.
Abgelöstes Feld: duration (Text, z. B. 2m 30s) wird bis zum Entfall am 18.01.2027 weiter neben durationMs geliefert. Lies durationMs.
status ist open, acknowledged oder resolved. Laufende Vorfälle haben ein null bei endedAt und isOngoing: true.
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.
Häufige Fehler
400 IMAP/POP monitor public ID (UUID) requiredwenn:imapPopMonitorPublicIdungültig ist400 Bad Request(invalidRequestBody) wenn ein Query-Parameter ungültig ist:page/limitkeine positive Ganzzahl,formatwederjsonnochcsv,downloadweder0noch1, oder ein unbekannter Wert instatusodertype400 Bad Request(invalidDateRange) wennfromodertokein Datum ist401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf den Monitor hast