FTP Monitore auflisten

GET /api/ftp-monitors

Authentifizierung

Authorization: Bearer <token>

Parameter

organizationId (Query, optional): Organisations-ID. Default ist die Organisation des aktuellen Nutzers.
customerId (Query, optional): Nach Kunden-ID filtern.
search (Query, optional): Suche nach Name, Hostname oder Kunde.
page (Query, optional): Seite (Default: 1).
perPage (Query, optional): Einträge pro Seite (Default: 50, Max: 200).

Hinweis: Die Ergebnisse sind zusätzlich durch deinen Customer-Scope begrenzt (falls dein Account auf eine Teilmenge von Kunden eingeschränkt ist).

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET \
  "$BASE_URL/api/ftp-monitors?page=1&perPage=50&search=ftp" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "items": [
    {
      "id": 400,
      "organizationId": 1,
      "customerId": 10,
      "customerName": "Example Customer",
      "name": "Partner FTP",
      "hostname": "ftp.deinkunde.com",
      "port": 21,
      "status": "active",
      "checkInterval": 30,
      "timeoutSeconds": 30,
      "allowedCheckCountryCodes": null,
      "config": {
        "user": "monitor",
        "password": "<ftp-password>",
        "secure": false
      },
      "notificationPhoneNumber": null,
      "notificationEmail": null,
      "lastCheckedAt": null,
      "createdAt": "2026-02-25T10:00:00.000Z",
      "updatedAt": "2026-02-25T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 50
}

Jedes Item enthält den FTP-Monitor selbst und ein flaches customerName, aber keinen vollständig eingebetteten Kunden-Datensatz.

Inline-Metriken

Jeder Eintrag traegt dieselben verdichteten Kennzahlen, die auch die uebrigen Monitor-Listen liefern. Sie werden je Monitor ueber den Kalendertag, den Monat und das Jahr in UTC gebildet.

Feld	Typ	Bedeutung
`uptimeDay` / `uptimeMonth` / `uptimeYear`	string	Verfuegbarkeit in Prozent mit zwei Nachkommastellen, z. B. `"99.94"`
`avgResponseDay` / `avgResponseMonth` / `avgResponseYear`	number \| null	Mittlere Antwortzeit in Millisekunden; `null`, wenn in dem Fenster nichts gemessen wurde
`responseGraph`	object	`{ values, avg }` fuer die letzten 24 Stunden, ein Eintrag je Stunde; eine Stunde ohne erfolgreiche Pruefung ist `null`
`upSinceAt`	string \| null	ISO-Zeitpunkt, seit dem der Monitor laeuft, `null` solange er ausgefallen ist
`isDown`	boolean	Ob der Monitor gerade in einem unaufgeloesten Vorfall steckt

Die Tageswerte kommen aus den Rohdaten, Monat und Jahr aus fortlaufenden Aggregaten -- in diesen beiden Fenstern kann ein Wert der neuesten Pruefung daher um einige Minuten hinterherhinken.

Häufige Fehler

400 Invalid organizationId wenn organizationId keine gültige Zahl ist
401 Unauthorized wenn du nicht authentifiziert bist
403 Forbidden wenn du keinen Zugriff auf die Organisation hast

FTP Monitore auflisten

AuthentifizierungAnkerlink kopieren

ParameterAnkerlink kopieren

Beispiel (cURL)Ankerlink kopieren

ResponseAnkerlink kopieren

Inline-MetrikenAnkerlink kopieren

Häufige FehlerAnkerlink kopieren