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.example.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.

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