UniFi Site Manager

Erklärung für den Block UniFi (Cloud API).

Kategorie: Integrationen & Business | Quelldatei: unifiBlock.js

---

Kurzbeschreibung

Ein Block für die UniFi Site Manager API (https://api.ui.com) — nicht für lokale Controller im LAN. Jeder API-Key gehört zu einem UI-Konto und damit zu einem „Tenant“.

Multi-Tenant (mehrere Kunden-Keys):

• API-Key direkt im Block oder im Tool-Input (apiKey)
• Oder in den Einstellungen als Objekt, z. B. unifi: { "Kunde A": "key…", "Kunde B": "key…" } und im Flow apiKeyLabel = Kunde A

Operationen: Übersicht, Probleme (problems_report, all_customers_problems), Hosts, Sites, Geräte, ISP-Metriken (EA), SD-WAN (EA), custom_request.

API-Key besorgen

1. unifi.ui.com → Einstellungen / API
2. API-Key erstellen
3. In Uella unter Auth UniFi oder im Block hinterlegen

Typische Agent-Aufgaben

Aufgabe	Operation	Parameter
Alle Probleme aller Kunden	all_customers_problems	Mehrere Keys als unifi-Objekt in Einstellungen
Probleme eines Kunden	problems_report	apiKeyLabel: "Kunde A"
Mandanten-Check	overview	apiKeyLabel oder apiKey
Alle Sites	site_list	—
Offline-Geräte finden	device_list	search: offline
Host-Details	host_get	hostId
WAN-Qualität	isp_metrics_get	ispMetricType: 1h, ispDuration: 7d

„Liste alle Probleme von allen Kunden“

Im Agent-Chat z. B.: „Zeig mir alle Probleme über alle UniFi-Kunden“ — der Agent soll operation: all_customers_problems wählen.

Voraussetzung: In den API-Einstellungen mehrere Keys als JSON-Objekt, nicht nur ein einzelner String:

{
  "Kunde Müller": "DEIN-API-KEY-1",
  "Kunde Meier": "DEIN-API-KEY-2"
}

Erkannt werden u. a.: offline Hosts/Geräte, kritische Site-Notifications, ausstehende Firmware-Updates. Es gibt kein separates „Alerts“-Endpoint in der Site-Manager-API — das ist eine aggregierte Auswertung der verfügbaren Statistiken.

Hinweise

• v1 = stabil (/v1/hosts, /v1/sites, /v1/devices)
• ea = Early Access, kann sich ändern (/ea/isp-metrics, /ea/sd-wan-configs)
• Rate Limits: v1 ca. 10 000/min, EA ca. 100/min
• Lokale Controller-API (UDM proxy/network) ist nicht Teil dieses Blocks