FTP Monitor Check-Historie abrufen
Gibt die letzten FTP-Check-Ergebnisse für einen Monitor zurück.
GET /api/ftp-monitors/:ftpMonitorPublicId/check-history
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
ftpMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des FTP 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/ftp-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.
Häufige Fehler
400 FTP monitor public ID (UUID) requiredwennftpMonitorPublicIdfehlt oder ungültig ist400 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 ist401 Unauthorizedwenn du nicht authentifiziert bist403 Forbiddenwenn du keinen Zugriff hast404 FTP monitor not foundwenn der Monitor nicht existiert