Skip to Content
Uptimeify Docs

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, year
  • date (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. Nutze granularity=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) wenn range nicht day/week/month/year ist, date/startDate/endDate kein Datum ist, nur eines von startDate/endDate kommt, tz keine Ganzzahl ist oder granularity weder raw noch aggregated
  • 400 Invalid FTP monitor public ID (UUID) wenn ftpMonitorPublicId ungültig ist
  • 401 Unauthorized wenn du nicht authentifiziert bist
  • 403 Forbidden wenn du keinen Zugriff hast
  • 500 Failed to fetch FTP monitor details bei Serverfehlern

Auf dieser Seite