Mit dem API-Zugriff holen Sie sich Ihre Anlagendaten in Ihre eigenen Systeme – zum Beispiel in Grafana, Home Assistant, Node-RED oder ein eigenes Skript. Dafür erstellen Sie in der App einen persönlichen API-Token, mit dem Ihre Anwendung die Daten abrufen darf. Diese Funktion ist Teil von Solakon Premium. Diese Funktion richtet sich an technisch versierte Nutzer – Grundkenntnisse im Umgang mit APIs sind hilfreich.
Das brauchen Sie
- Ein aktives Solakon-Premium-Abo.
- Eine Anwendung oder ein System, das HTTP-Anfragen stellen kann.
So erstellen Sie einen Token
- Öffnen Sie in der App Profil → API-Tokens und tippen Sie auf Erstellen.
- Geben Sie einen Namen ein (z. B. „Home Assistant“) und wählen Sie die Berechtigungen: Geräte lesen, Produktion lesen, Gruppen lesen.
- Kopieren Sie den Token sofort – aus Sicherheitsgründen wird er nur dieses eine Mal angezeigt.
- Hinterlegen Sie den Token in Ihrem System. Er wird bei jeder Anfrage im Authorization-Header mitgesendet. Die Basis-URL, alle Endpunkte, Parameter und Beispielantworten finden Sie direkt in der App in der eingebauten API-Dokumentation. Dort können Sie über API testen auch echte Anfragen ausprobieren und den fertigen curl-Befehl kopieren.
Was die API kann
- Geräte und Gerätedetails abrufen, inklusive Echtzeitdaten.
- Energiestatistiken für Tag, Woche, Monat oder gesamt abfragen.
- Gruppen, Konto-Zusammenfassung und Solakon PowerTracker IR Smart Meter auslesen. Wichtig zu wissen: Die API ist rein lesend – Geräte lassen sich darüber nicht steuern. Es gilt ein Limit von 120 Anfragen pro Minute.
Häufige Fragen und Probleme
- Ich habe den Token verloren: Ein Token kann nicht erneut angezeigt werden. Widerrufen Sie ihn einfach und erstellen Sie einen neuen.
- Ich möchte einer Anwendung den Zugriff entziehen: Widerrufen Sie den Token in der App – der Zugriff endet sofort.
- Fehler 401 oder 403: Prüfen Sie, ob der Token korrekt im Authorization-Header steht und die passende Berechtigung hat.
- Fehler 429: Ihre Anwendung fragt zu häufig an. Reduzieren Sie die Abfragefrequenz auf höchstens 120 Anfragen pro Minute.