FTP Monitor Details abrufen
Gibt die FTP-Monitor-Detailseiten-Daten in einem Call zurück (Mega-Endpoint).
GET /api/ftp-monitors/:ftpMonitorPublicId/details
Authentifizierung
Authorization: Bearer <token>
Parameter
ftpMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des FTP Monitors.
Query Parameter
range(optional):day(default),week,month,yeardate(optional): Referenzdatum (ISO String)startDate/endDate(optional): Überschreibt das Zeitfenster (ISO Strings)granularity(optional): Wenn weggelassen, kann der Server bei großen Zeiträumen automatisch aggregieren. Nutzegranularity=raw, um Raw-Daten zu erzwingen.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET \
"$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555/details?range=day" \
-H "Authorization: Bearer $TOKEN"Beispiel Response (Shape)
Die Response ist ein einzelnes Objekt mit diesen Top-Level Keys:
{
"ftpMonitorId": 400,
"monitor": {},
"latestCheck": {},
"uptimeStats": {
"day": "100.00",
"month": "100.00",
"year": "100.00",
"dayAvgResponse": 120,
"monthAvgResponse": 130,
"yearAvgResponse": 140
},
"uptimeStatsMeta": {},
"monitoringData": {
"responseTimeData": [],
"statusData": [],
"uptimePercentage": "100.00",
"checkSuccessRatePercentage": "100.00",
"totalChecks": 10,
"successfulChecks": 10
},
"incidents": {
"history": [],
"total": 0,
"ongoing": 0,
"totalDowntime": "0s"
},
"alerts": {
"history": [],
"total": 0,
"notificationContext": {}
},
"testResultLog": null,
"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.
Häufige Fehler
400 Bad Request(invalidRequestBody) wennrangenichtday/week/month/yearist,date/startDate/endDatekein Datum ist, nur eines vonstartDate/endDatekommt,tzkeine Ganzzahl ist odergranularitywederrawnochaggregated400 Invalid FTP monitor public ID (UUID)wennftpMonitorPublicIdungültig ist401 Unauthorizedwenn du nicht authentifiziert bist403 Forbiddenwenn du keinen Zugriff hast500 Failed to fetch FTP monitor detailsbei Serverfehlern