Erforderliche Informationen, Einrichtung und Überprüfung für Solarman (API).
Eniris kann Ihre Anlagen- und Gerätedaten über die offizielle SOLARMAN Open API auslesen. Sie beantragen den API-Zugriff einmalig bei Solarman. Anschließend übermitteln Sie Eniris vier Werte über unser Supportportal.
Eine zuverlässige API-Verbindung kombiniert die richtige Autorisierungsmethode, einen ausdrücklich begrenzten Installationsumfang und einen überprüften ersten Abruf.
Verbindungstyp: API- und Plattformverbindung.
Stellen Sie sicher, dass Sie Folgendes haben:
globalapi.solarmanpv.com). Konten im chinesischen Rechenzentrum können von diesem Konnektor nicht ausgelesen werden.Der API-Zugriff ist standardmäßig nicht aktiviert. Senden Sie Ihre Anfrage an Ihren Solarman-Geschäftskontakt oder an die Serviceadresse service@solarmanpv.com. Solarman möchte wissen, wer Sie sind, welcher Kundentyp Sie sind und wofür Sie die API verwenden werden. Die Open-API-Dokumentation beschreibt das Verfahren. Sie können auch ein Ticket im SOLARMAN Help Centre.
eröffnen. Verwenden Sie die nachstehende Vorlage. Ersetzen Sie die Werte zwischen den spitzen Klammern und löschen Sie nicht zutreffende Angaben.
Subject: OpenAPI activation request for <your Solarman account email>
Dear Solarman support,
I would like to activate the OpenAPI for my SOLARMAN account.
Solarman account (email): <your Solarman login>
Platform: SOLARMAN Smart / SOLARMAN Business
Data centre: International
Customer type: individual / equipment manufacturer / installation and
maintenance provider / distributor / investor
Number of plants: <number>
Reason: my PV installation is monitored by Eniris (https://eniris.com).
Eniris reads my plant and device data through the SOLARMAN OpenAPI for
monitoring and reporting.
Please send the APP ID and APP SECRET to this email address.
Kind regards,
<name>, <company>
Solarman registriert Sie als Entwickler und erstellt die Anwendung. Anschließend wird die Anwendung geprüft. Solarman kann Sie auffordern, die API Developer Agreement per E-Mail an customerservice@solarmanpv.com zu bestätigen, bevor die Aktivierung fortgesetzt wird.
Nach Abschluss der Prüfung aktiviert Solarman die API und sendet die APP ID und APP SECRET an Ihre E-Mail-Adresse.
Sie müssen selbst kein Zugriffstoken oder Aktualisierungstoken erstellen. Eniris übernimmt dies anhand der nachstehenden Werte.
| Informationen / Einstellung | Erforderliche Angaben |
|---|---|
Anwendungs-ID (APP_ID) | Wird von Solarman nach der API-Aktivierung ausgestellt. |
Anwendungsgeheimnis (APP_SECRET) | Geheimnis, das zu dieser APP ID gehört. |
Konto-E-Mail-Adresse (EMAIL) | Das Solarman-Konto, das die Anlagen sehen kann. |
Kontopasswort (PASSWORD) | Passwort dieses Kontos. |
| Anlagenumfang | Die Anlagen, die Eniris auslesen darf. |
Verwenden Sie nach Möglichkeit ein separates Solarman-Konto für Eniris und teilen Sie die relevanten Anlagen mit diesem Konto. Das ist sicherer, als einen persönlichen oder Administratorkontozugang zu übergeben.
Wichtig: behandeln Sie das APP SECRET und das Kontopasswort wie Passwörter. Fügen Sie sie niemals in eine E-Mail, ein Ticket oder eine Chatnachricht ein.
Teilen Sie das Geheimnis und das Passwort über einen einmalig verwendbaren Geheimlink und fügen Sie diesen Link in ein Supportticket ein. Dadurch wird nichts im Klartext gespeichert.
Der Link kann nur einmal geöffnet werden. Nachdem Eniris ihn gelesen hat, kann ihn niemand sonst mehr öffnen.
Kopieren Sie dies in das Ticket. Lassen Sie die Anlagenliste leer, wenn Sie alle Anlagen wünschen.
Subject: New Solarman (API) connection
Hello Eniris team,
We would like to connect our Solarman installation through the official
Solarman Open API.
APP ID: <your APP ID>
Solarman account (email): <your Solarman login>
APP SECRET and password (one-time secret link): <paste link here>
Plants to collect:
Kind regards,
:::caution Eine Änderung Ihres Solarman-Passworts beendet die Datenerfassung Solarman sperrt den API-Zugriff, sobald das Kontopasswort zurückgesetzt oder geändert wird. Dasselbe geschieht, wenn sich die Rolle des Kontos ändert. Die Verbindung beendet daraufhin die Datenerfassung, und für diesen Zeitraum werden keine Daten gespeichert. Eröffnen Sie ein Ticket, bevor Sie das Passwort ändern, und senden Sie die neuen Zugangsdaten über einen neuen, einmalig verwendbaren Geheimlink. Wir können die Verbindung dann noch am selben Tag aktualisieren. :::
Welche Daten wir erfassen, hängt von Ihrer Ausstattung ab.
| Ebene | Erfasste Daten |
|---|---|
| Anlage | Name, installierte Leistung, Zeitzone, Koordinaten, Adresse, Inbetriebnahmedatum, Erzeugungsleistung und Erzeugung |
| Wechselrichter | Gesamt-AC-Leistung, Gesamtertrag, Phasenspannungen, Außenleiterspannungen und Phasenströme |
| Hybrid-Wechselrichter | Gesamt-AC-Leistung, importierte und exportierte Energie |
| Gerät | Ladezustand, Gesundheitszustand, geladene und entladene Energie, Leistung, Strom und Spannung |
| Optimierer | Spannung, Strom, Leistung und Ertrag je Optimierer |
| Netzzähler | Gesamtleistung und Leistung je Phase, Blindleistung, Außenleiterspannungen, importierte und exportierte Energie |
| Verbrauchszähler | Importierte Energie und Leistung |
| Alarme | Gerätealarme, verknüpft mit dem jeweiligen Gerät |
Solarman legt die Bedingungen für den API-Zugriff fest und kann dafür Gebühren erheben. Dies hängt von Ihrer Plattform, der Anzahl der Anlagen und der erforderlichen Anzahl von Aufrufen ab. Fragen Sie Solarman bei der Aktivierungsanfrage, welche Bedingungen für Ihr Konto gelten. Die Seite zu den API-Zugriffsbedingungen enthält die aktuelle Übersicht.
Haben Sie Fragen zu den oben beschriebenen Schritten? Wenden Sie sich an den Eniris-Support. Wir helfen Ihnen gerne weiter.
Alle Anleitungen zur Verbindungseinrichtung