Table of contents
API
Version: 2.0.0 Gültigkeit: interne Verträge und ausgehende Connectoren Letzter Stand: 4. Juli 2026
Die App stellt noch keine eigene REST-API bereit. Diese Seite beschreibt die produktiven ausgehenden Connectoren.
Inhalt
| Seit | Connector | Zugriff |
|---|---|---|
| 1.1.0 | Proxmox VE | Nodes und Gäste lesen; bestätigte Gastaktionen |
| 1.2.0 | Portainer | Umgebungen, Stacks und Container lesen |
| 1.3.0 | AdGuard Home | Clients und DNS-Rewrites lesen |
| 1.4.0 | Nginx Proxy Manager | Proxy-Hosts und SSL-Zustände lesen |
| 2.0.0 | Bastelhof Agent | authentifizierten Systemstatus lesen |
Der AgentConnector akzeptiert ausschließlich absolute HTTPS-Endpunkte, sendet den Bearer-Token aus dem Windows Credential Manager und liest GET /api/v1/status. Der Agent bietet keine schreibenden Endpunkte.
Die interne Plugin-API 1 besteht aus IHomelabPlugin, Metadaten, Aktionsbeschreibungen und einer asynchronen Ausführung mit Textparametern. Manifest, Host-/API-Version, Assembly-SHA-256, Vertrauen und Aktivierung werden geprüft, bevor Code geladen wird.
ISshConnector ist nur als späterer Stub vorhanden. Verträge und Transportmodelle liegen im Connector-Projekt; Implementierungen werden durch Vertragstests abgesichert.
Hinweise
Connectoren verwenden HTTPS, Zeitüberschreitungen, Abbruchtoken, Windows Credential Manager und bereinigte Fehlermeldungen. Neue Integrationen starten grundsätzlich lesend.