Deco BE85
Basis-URL: https://deco.msageha.net/api (FastAPI-Wrapper um die lokale TP-Link
Deco BE85 API). Anfragen an diese Instanz benötigen keinen Authentifizierungs-Header
oder Cookie – der Server meldet sich selbst mit gespeicherten Anmeldedaten am Router an.
Wichtige Fakten
- Die Anmeldung am Router erfolgt verzögert: Der erste Aufruf nach dem Start/Leerlauf löst sie aus und ist langsamer. Abgelaufene Sitzungen werden automatisch erneut angemeldet und die Anfrage wiederholt.
- Anfragen werden hinter einer serverseitigen Sperre serialisiert (einzelne Router-Sitzung). Rufe Endpunkte nacheinander auf; keine parallelen Anfragen.
bandistband2_4/band5_1/band6;networkisthost/guest.GET /wirelessgibtssid/passwordbase64-kodiert zurück; Schreib-Endpunkte akzeptieren sie im Klartext (der Server kodiert sie).- Bestätigung des Benutzers vor jedem Schreibvorgang einholen: Wi-Fi-Umschaltungen/Konfigurationsänderungen trennen kurzzeitig Clients auf diesem Band,
POST /reboot(erfordertconfirm: true) legt das gesamte Netzwerk für Minuten lahm, undPOST /rawmit einer Nicht-Lese-operationkann beliebige Router-Einstellungen ändern. - Fehler:
401Router-Authentifizierungsfehler,502Router-seitiger Fehler (detail+error_code),504Router nicht erreichbar,400/422Anfragevalidierung.
Kernoperationen
| Aufgabe | Endpunkt |
|---|---|
| Übersicht (WAN/CPU/Arbeitsspeicher/Knoten & Client-Anzahl) | GET /dashboard |
| Deco-Einheiten (Mesh-Knoten) | GET /devices |
| Verbundene Clients | GET /clients?online_only=true |
| Blockierte Clients | GET /clients/blocked |
| Wi-Fi-Einstellungen (alle Bänder, host/guest) | GET /wireless |
| Wi-Fi EIN/AUS pro Band | POST /wireless |
| SSID/Passwort/Kanal usw. ändern | POST /wireless/config |
| WAN / Internet / LAN / IPv6-Status | GET /network/wan, /network/internet, /network/lan, /network/ipv6 |
| CPU-/Arbeitsspeicherauslastung | GET /network/performance |
| Deco-Einheiten neustarten (zerstörerisch) | POST /reboot |
| Jeder andere Deco-Endpunkt (Notausstieg) | POST /raw |
| Server-Health / explizite Anmeldung | GET /health, POST /login, POST /logout |
Vollständige Anfrage-/Antwortschemata und ausführbare curl-Beispiele: siehe references/api-reference.md und references/commands.md.