SolarEdge (Unabhängiger Herausgeber) (Vorschau)
Der SolarEdge Connector bietet Ihnen die Möglichkeit, Systemdaten in anderen Anwendungen anzuzeigen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Richard Wierenga |
| URL | https://knowledge-center.solaredge.com/ |
| rwconnectors@gmail.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Richard Wierenga |
| Webseite | https://www.solaredge.com/ |
| Datenschutzrichtlinie | https://monitoring.solaredge.com/solaredge-web/p/license |
| Kategorien | Internet der Dinge; Daten |
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Die api_key für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Meterdaten |
Gibt für jeden Zähler auf der Website seine Lebensdauer Energielesewert, Metadaten und das Gerät zurück, mit dem es verbunden ist. |
| Geräteänderungsprotokoll |
Gibt eine Liste der Nach Datum sortierten Gerätekomponentenersatz zurück. Diese Methode gilt für Wechselrichter, Optimierer, Batterien und Gateways. |
| Komponentenliste |
Zurückgeben einer Liste von Wechselrichtern/SMIs am jeweiligen Standort |
| Power Flow der Website |
Ruft den aktuellen Stromfluss zwischen allen Elementen des Standorts ab, einschließlich PV-Array, Speicher (Batterie), Lasten (Verbrauch) und Netz. |
| Sensorliste abrufen |
Gibt eine Liste aller Sensoren am Standort und das Gerät zurück, mit dem sie verbunden sind. |
| Site Energy – Zeitraum |
Gibt die Gesamtenergie der Website zurück, die für einen bestimmten Zeitraum erzeugt wurde. |
| Speicherinformationen |
Erhalten Sie detaillierte Speicherinformationen von Batterien: energie-, Energie- und Lebensdauerenergie. |
| Standortenergie |
Zurückgeben der Energiemessungen am Standort |
| Standortenergie - Detailliert |
Detaillierte Standort-Energiemessungen von Metern wie Verbrauch, Export (Futtermittel), Import (Kauf) usw. |
| Standortleistung |
Zurückgeben der Standortleistungsmessungen in einer Auflösung von 15 Minuten |
| Standortleistung – Detailliert |
Detaillierte Standortleistungsmessungen von Metern wie Verbrauch, Export (Einspeisen), Import (Kauf) usw. |
| Technische Daten des Wechselrichters |
Geben Sie spezifische Wechselrichterdaten für einen bestimmten Zeitraum zurück. |
| Umweltvorteile der Website |
Gibt alle Umweltvorteile basierend auf der Energieproduktion an der Website zurück: CO2-Emissionen gespeichert, gleichwertige Bäume gepflanzt und Glühbirnen für einen Tag betrieben. |
| Websitedetails |
Zeigt die Websitedetails an, z. B. Name, Standort, Status usw. |
| Websiteinventar |
Geben Sie das Inventar der SolarEdge-Ausrüstung am Standort zurück, einschließlich Wechselrichter/SMIs, Batterien, Meter, Gateways und Sensoren. |
| Websiteliste |
Gibt eine Liste von Websites zurück, die sich auf das angegebene Token beziehen, bei dem es sich um das Konto api_key handelt. Diese API akzeptiert Parameter für eine bequeme Suche, Sortierung und Paginierung. |
| Websiteübersicht |
Die Antwort umfasst die Stromkraft des Standorts, tägliche Energie, monatliche Energie, jährliche Energie und Lebenszeitenergie. |
Abrufen von Meterdaten
Gibt für jeden Zähler auf der Website seine Lebensdauer Energielesewert, Metadaten und das Gerät zurück, mit dem es verbunden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Aggregations granularität
|
timeUnit | string |
Aggregations granularität, zulässige Werte sind QUARTER_OF_AN_HOUR, STUNDE, TAG, WOCHE, MONAT, JAHR |
|
|
Die energie gemessene Startzeit im Format jjjj-MM-DD hh:mm:ss
|
startTime | True | string |
Die energie gemessene Startzeit im Format jjjj-MM-DD hh:mm:ss |
|
Die energie gemessene Endzeit im Format jjjj-MM-DD hh:mm:ss
|
endTime | True | string |
Die energie gemessene Endzeit im Format jjjj-MM-DD hh:mm:ss |
|
Nur bestimmte Meter auswählen
|
meters | string |
Wählen Sie nur bestimmte Meter aus. Wenn dieser Wert nicht angegeben wird, werden alle Zählerwerte zurückgegeben. Zulässige Werte sind "Produktion", "Verbrauch", "FeedIn", "Gekauft" |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Aggregations granularität |
|
Einheit
|
meterEnergyDetails.unit | string |
Zurückgegebene Metereinheit (Wh) |
|
Meter
|
meterEnergyDetails.meters | array of object |
Werte pro Meter |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Wechselrichter, an den der Zähler angeschlossen ist |
|
Modell
|
meterEnergyDetails.meters.model | string |
Metermodell |
|
MessgerätTyp
|
meterEnergyDetails.meters.meterType | string |
Metertyp Produktion, Verbrauch, FeedIn oder gekauft |
|
values
|
meterEnergyDetails.meters.values | array of object |
Werte pro Meter pro Datum |
|
date
|
meterEnergyDetails.meters.values.date | string |
Messzeitstempel |
|
value
|
meterEnergyDetails.meters.values.value | float |
Lebensdauer des Energiewertes |
Geräteänderungsprotokoll
Gibt eine Liste der Nach Datum sortierten Gerätekomponentenersatz zurück. Diese Methode gilt für Wechselrichter, Optimierer, Batterien und Gateways.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Die Seriennummer des Geräts
|
equipment_id | True | string |
Die Seriennummer des Geräts |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Ausrüstung kurze Seriennummer |
|
Teilenummer
|
ChangeLog.list.partNumber | string |
Wechselrichter/Batterie/Optimierer/Gatewaymodell |
|
date
|
ChangeLog.list.date | string |
Datum des Austauschs dieser Ausrüstungskomponente |
Komponentenliste
Zurückgeben einer Liste von Wechselrichtern/SMIs am jeweiligen Standort
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
count
|
reporters.count | integer |
Anzahl der Websiteskomponenten |
|
Liste
|
reporters.list | array of object |
Liste |
|
componentname
|
reporters.list.componentname | string |
Der Komponentenname |
|
manufacturer
|
reporters.list.manufacturer | string |
Der Komponentenhersteller |
|
Model
|
reporters.list.Model | string |
Das Komponentenmodell |
|
Seriennummer
|
reporters.list.SerialNumber | string |
SerialNumber der Komponente |
Power Flow der Website
Ruft den aktuellen Stromfluss zwischen allen Elementen des Standorts ab, einschließlich PV-Array, Speicher (Batterie), Lasten (Verbrauch) und Netz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Einheit
|
siteCurrentPowerFlow.unit | string |
Die Maßeinheiten (z. B. Watt) |
|
Verbindungen
|
siteCurrentPowerFlow.connections | array of object |
Eine Tabelle, die alle Beziehungen zwischen den Elementen und die Richtungen des Stromflusses enthält (produzierendes Element und verbrauchendes Element) |
|
from
|
siteCurrentPowerFlow.connections.from | string |
Das Element, das Energie bereitstellt |
|
zu
|
siteCurrentPowerFlow.connections.to | string |
Das Element, das Energie verbraucht |
|
status
|
siteCurrentPowerFlow.GRID.status | string |
Rasterstatus (Aktiv/Leerlauf/Deaktiviert) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
Stromstrom |
|
status
|
siteCurrentPowerFlow.LOAD.status | string |
Ladestatus (Aktiv/Leerlauf/Deaktiviert) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
Stromlast Power |
|
status
|
siteCurrentPowerFlow.PV.status | string |
PV-Status (Aktiv/ Leerlauf/ Deaktiviert) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
Strom-PV-Leistung |
|
status
|
siteCurrentPowerFlow.STORAGE.status | string |
Speicherstatus (Aktiv/Leerlauf/Deaktiviert) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
Stromspeicher |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
Storage chargeLevel |
|
Kritisch
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
Speicher kritisch? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
Im Sicherungsmodus, angegebene Zeit, bevor der Speicher ausläuft |
Sensorliste abrufen
Gibt eine Liste aller Sensoren am Standort und das Gerät zurück, mit dem sie verbunden sind.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
Die Anzahl des Standortsensors |
|
Liste
|
SiteSensors.list | array of object |
Liste pro Gateway |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Name des Gateways, mit dem der Sensor verbunden ist |
|
count
|
SiteSensors.list.count | integer |
Die Anzahl der Gateways-Sensor |
|
sensors
|
SiteSensors.list.sensors | array of object |
sensors |
|
name
|
SiteSensors.list.sensors.name | string |
Sensorname |
|
Messung
|
SiteSensors.list.sensors.measurement | string |
Was der Sensor misst, z.B. SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
type
|
SiteSensors.list.sensors.type | string |
was der Sensor misst, z.B. SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Site Energy – Zeitraum
Gibt die Gesamtenergie der Website zurück, die für einen bestimmten Zeitraum erzeugt wurde.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Der Starttermin zur Rückgabe der Energiemessung
|
startDate | True | string |
Der Starttermin zur Rückgabe der Energiemessung |
|
Das Enddatum gibt Energiemessung zurück.
|
endDate | True | string |
Das Enddatum gibt Energiemessung zurück. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
Energiezusammenfassung |
|
Einheit
|
timeFrameEnergy.unit | string |
Energieeinheit (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
Die Quelle der Messungen |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Angegebene Startdatumsinformationen |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Startdatum Energie |
|
Einheit
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Startdatumseinheit (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Angegebene Enddatumsinformationen |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Enddatumsenergie |
|
Einheit
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Enddatumseinheit (Wh) |
Speicherinformationen
Erhalten Sie detaillierte Speicherinformationen von Batterien: energie-, Energie- und Lebensdauerenergie.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Der Websitebezeichner
|
startTime | True | string |
Der Websitebezeichner |
|
Der Websitebezeichner
|
endTime | True | string |
Der Websitebezeichner |
|
Daten nur für bestimmte Akku-Seriennummern zurückgeben
|
serials | string |
Gibt Daten nur für bestimmte Akku-Seriennummern zurück, die Liste ist durch Kommas getrennt. Ohne Angabe enthält die Antwort alle Batterien am Standort. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
Die Anzahl der Batterien enthält in der Antwort |
|
Batterien
|
storageData.batteries | array of object |
Eine Liste der Akkuobjekte |
|
Namensschild
|
storageData.batteries.nameplate | integer |
Die Nennkapazität des Akkus (Nennkapazität) |
|
serialNumber
|
storageData.batteries.serialNumber | string |
Die Seriennummer des Akkus |
|
Modellnummer
|
storageData.batteries.modelNumber | string |
Akkumodellnummer |
|
telemetryCount
|
storageData.batteries.telemetryCount | integer |
Die Anzahl der Telemetriedaten für diesen Akku in der Antwort |
|
Telemetrie
|
storageData.batteries.telemetries | array of object |
Eine Liste der Speicherdatentelemetrien |
|
Zeitstempel
|
storageData.batteries.telemetries.timeStamp | string |
Telemetriezeitstempel im Format JJJJ-MM-DD HH:MM:SS |
|
Macht
|
storageData.batteries.telemetries.power | integer |
Positive Leistung zeigt an, dass der Akku geladen wird, negatives Entladen |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Dies kann eine der folgenden 0 (ungültig), 1 (Standby), 2 (Thermal Mgmt.), 3 (Aktiviert), 4 (Fehler) sein. |
|
lifeTimeEnergieCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
Die Energie, die während der Akkulaufzeit von der Batterie in Wh geladen wird |
|
lifeTimeEnergieDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
Die energieausladung aus der Batterie in Wh, während der Akkulaufzeit |
|
fullPackEnergieAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
Die maximale Energie (Wh), die derzeit in der Batterie gespeichert werden kann |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Batterieinterne Temperatur in Celsius |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Menge an AC-Energie, die verwendet wird, um die Batterie aus dem Netz innerhalb eines bestimmten Datumsbereichs in Wh aufzuladen |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
der Akkuzustand als Prozentsatz der verfügbaren Kapazität. Die Werte liegen im Bereich von 0 bis 100. |
Standortenergie
Zurückgeben der Energiemessungen am Standort
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Aggregations granularität
|
timeUnit | True | string |
Aggregations granularität, zulässige Werte sind QUARTER_OF_AN_HOUR, STUNDE, TAG, WOCHE, MONAT, JAHR |
|
Der Starttermin zur Rückgabe der Energiemessung
|
startDate | True | string |
Der Starttermin zur Rückgabe der Energiemessung |
|
Das Enddatum gibt Energiemessung zurück.
|
endDate | True | string |
Das Enddatum gibt Energiemessung zurück. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Angeforderte Zeiteinheit |
|
Einheit
|
energy.unit | string |
Maßeinheiten |
|
measuredBy
|
energy.measuredBy | string |
Quelle der Messungen |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Datum und Uhrzeit |
|
value
|
energy.values.value | float |
Gemessene Leistung (d. h. Watt) bei angegebenen Datumsangaben |
Standortenergie - Detailliert
Detaillierte Standort-Energiemessungen von Metern wie Verbrauch, Export (Futtermittel), Import (Kauf) usw.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Aggregations granularität
|
timeUnit | True | string |
Aggregations granularität, zulässige Werte sind QUARTER_OF_AN_HOUR, STUNDE, TAG, WOCHE, MONAT, JAHR |
|
Die energie gemessene Startzeit im Format jjjj-MM-DD hh:mm:ss
|
startTime | True | string |
Die energie gemessene Startzeit im Format jjjj-MM-DD hh:mm:ss |
|
Die energie gemessene Endzeit im Format jjjj-MM-DD hh:mm:ss
|
endTime | True | string |
Die energie gemessene Endzeit im Format jjjj-MM-DD hh:mm:ss |
|
Nur bestimmte Meter auswählen
|
Meters | True | string |
Wählen Sie nur bestimmte Meter aus, wenn alles leer ist. Zulässige Werte sind PRODUKTION, KONSUM, Selbstvermutung, FeedIn, gekauft |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Angeforderte Zeiteinheit |
|
Einheit
|
energyDetails.unit | string |
Maßeinheiten |
|
Meter
|
energyDetails.meters | array of object |
Meter |
|
type
|
energyDetails.meters.type | string |
type |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Datum und Uhrzeit |
|
value
|
energyDetails.meters.values.value | float |
Gemessene Leistung (d. h. Watt) bei angegebenen Datumsangaben |
Standortleistung
Zurückgeben der Standortleistungsmessungen in einer Auflösung von 15 Minuten
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Das Startdatum und die Startzeit
|
startTime | True | string |
Startdatum und -uhrzeit (jjjj-mm-dd hh:mm:ss) zum Abrufen von Leistungsmessungen |
|
Das Startdatum und die Startzeit
|
endTime | True | string |
Startdatum und -uhrzeit (jjjj-mm-dd hh:mm:ss) zum Abrufen von Leistungsmessungen |
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Zeiteinheit (d. h. QUARTER_OF_AN_HOUR) |
|
Einheit
|
power.unit | string |
Maßeinheit (d. h. Watt) |
|
measuredBy
|
power.measuredBy | string |
Quelle der Messungen |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Datum und Uhrzeit |
|
value
|
power.values.value | float |
Gemessene Leistung (d. h. Watt) bei angegebenen Datumsangaben |
Standortleistung – Detailliert
Detaillierte Standortleistungsmessungen von Metern wie Verbrauch, Export (Einspeisen), Import (Kauf) usw.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Die energie gemessene Startzeit
|
startTime | True | string |
Die energie gemessene Startzeit im Format jjjj-MM-DD hh:mm:ss |
|
Die energie gemessene Endzeit
|
endTime | True | string |
Die energie gemessene Endzeit im Format jjjj-MM-DD hh:mm:ss |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Angeforderte Zeiteinheit |
|
Einheit
|
powerDetails.unit | string |
Maßeinheiten |
|
Meter
|
powerDetails.meters | array of object |
Zähler |
|
type
|
powerDetails.meters.type | string |
Der Metertyp (Produktion/Verbrauch/Selbstvermutung/FeedIn (Export)/Gekauft(Import)) |
|
values
|
powerDetails.meters.values | array of object |
Datumspaare und Energie für jedes Datum |
|
date
|
powerDetails.meters.values.date | string |
Datum und Uhrzeit |
|
value
|
powerDetails.meters.values.value | float |
Energie für angegebene Datumsangaben |
Technische Daten des Wechselrichters
Geben Sie spezifische Wechselrichterdaten für einen bestimmten Zeitraum zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
|
Die Seriennummer des Geräts
|
equipment_id | True | string |
Die Seriennummer des Geräts |
|
Start (Datum + Uhrzeit) zum Abrufen von Wechselrichterdaten
|
startTime | True | string |
Start (Datum + Uhrzeit) zum Abrufen von Wechselrichterdaten |
|
Das Ende (Datum + Uhrzeit) zum Abrufen von Wechselrichterdaten
|
endTime | True | string |
Das Ende (Datum + Uhrzeit) zum Abrufen von Wechselrichterdaten |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
count
|
data.count | integer |
Anzahl der Antworten |
|
Telemetrie
|
data.telemetries | array of object |
Telemetrie |
|
threePhaseInverterTelemetry
|
data.telemetries.threePhaseInverterTelemetry | array of object |
threePhaseInverterTelemetry |
|
date
|
data.telemetries.threePhaseInverterTelemetry.date | string |
date |
|
totalActivePower
|
data.telemetries.threePhaseInverterTelemetry.totalActivePower | string |
totalActivePower |
|
dcVoltage
|
data.telemetries.threePhaseInverterTelemetry.dcVoltage | float |
dcVoltage |
|
groundFaultResistance
|
data.telemetries.threePhaseInverterTelemetry.groundFaultResistance | float |
groundFaultResistance |
|
powerLimit
|
data.telemetries.threePhaseInverterTelemetry.powerLimit | float |
powerLimit |
|
totalEnergie
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
totalEnergie |
|
Temperatur
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Temperatur in Celsius |
|
wechselrichterMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
Zustand des Wechselrichters, z. B. OFF, START, MPPT usw. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Betriebsmodus ganzzahl 0 On-Grid, 1 Betrieb im Off-Grid-Modus mit PV oder Batterie, 2 im Off-Grid-Modus mit Generator |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage | float |
acVoltage |
|
AcFrequency
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency | float |
AcFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.activePower | integer |
activePower |
|
reaktivPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reaktivPower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L1Data.cosPhi | integer |
cosPhi |
|
vL1To2
|
data.telemetries.threePhaseInverterTelemetry.vL1To2 | float |
vL1To2 |
|
vL2To3
|
data.telemetries.threePhaseInverterTelemetry.vL2To3 | float |
vL2To3 |
|
vL3To1
|
data.telemetries.threePhaseInverterTelemetry.vL3To1 | float |
vL3To1 |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acVoltage | float |
acVoltage |
|
AcFrequency
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acFrequency | float |
AcFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.activePower | integer |
activePower |
|
reaktivPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reaktivPower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L2Data.cosPhi | integer |
cosPhi |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acVoltage | float |
acVoltage |
|
AcFrequency
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acFrequency | float |
AcFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.activePower | integer |
activePower |
|
reaktivPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reaktivPower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Umweltvorteile der Website
Gibt alle Umweltvorteile basierend auf der Energieproduktion an der Website zurück: CO2-Emissionen gespeichert, gleichwertige Bäume gepflanzt und Glühbirnen für einen Tag betrieben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Einheiten
|
envBenefits.gasEmissionSaved.units | string |
Einheiten für die restlichen Ergebnisse |
|
CO2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 in Kg oder Lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 in Kg oder Lb |
|
Nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX in Kg oder Lb |
|
bäumePlanted
|
envBenefits.treesPlanted | float |
Gleichwertige Pflanzung neuer Bäume zur Verringerung der CO2-Werte |
|
Glühbirnen
|
envBenefits.lightBulbs | float |
Anzahl der Glühbirnen, die von der Website für einen Tag angetrieben werden könnten |
Websitedetails
Zeigt die Websitedetails an, z. B. Name, Standort, Status usw.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
details.id | integer |
Die Website-ID |
|
name
|
details.name | string |
Der Websitename |
|
accountId
|
details.accountId | integer |
Das Konto, zu dem diese Website gehört |
|
status
|
details.status | string |
Der Websitestatus |
|
peakPower
|
details.peakPower | float |
Die Standorte peakPower |
|
Währung
|
details.currency | string |
Die Währung der Websites |
|
installationDate
|
details.installationDate | string |
Datum und Uhrzeit der Standortinstallation, Format jjjj-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
Berechtigung zum Betriebsdatum |
|
Notizen
|
details.notes | string |
Hinweise |
|
type
|
details.type | string |
Websitetyp |
|
country
|
details.location.country | string |
Das Land der Websites |
|
city
|
details.location.city | string |
Die Stadt der Sehenswürdigkeiten |
|
address
|
details.location.address | string |
Die Websiteadresse |
|
adresse2
|
details.location.address2 | string |
Die Websiteadresse2 |
|
zip
|
details.location.zip | string |
Die Websites zippen |
|
timeZone
|
details.location.timeZone | string |
Die TimeZone der Websites |
|
Landesvorwahl
|
details.location.countryCode | string |
Die Ländervorwahl der Websites |
|
alertQuantity
|
details.alertQuantity | integer |
Anzahl der geöffneten Warnungen auf dieser Website |
|
alertSeverity
|
details.alertSeverity | string |
Der höchste Warnungsschweregrad auf dieser Website |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
Der Websitebild-URI |
Websiteinventar
Geben Sie das Inventar der SolarEdge-Ausrüstung am Standort zurück, einschließlich Wechselrichter/SMIs, Batterien, Meter, Gateways und Sensoren.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Meter
|
Inventory.meters | array of object |
Liste der Meter für die angegebene Website |
|
name
|
Inventory.meters.name | string |
Metername |
|
manufacturer
|
Inventory.meters.manufacturer | string |
Meterhersteller |
|
Modell
|
Inventory.meters.model | string |
Metermodell |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
Meter firmwareVersion |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– Name des SolarEdge-Geräts, an das der Zähler angeschlossen ist |
|
type
|
Inventory.meters.type | string |
Metertyp z.B. "Produktion" |
|
Form
|
Inventory.meters.form | string |
physisch für einen HW-Meter oder eine virtuelle, wenn durch Arithmetik zwischen anderen Metern berechnet wird |
|
sensors
|
Inventory.sensors | array of object |
Liste der Sensoren für die angegebene Website |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– Name des SolarEdge-Geräts, mit dem der Sensor verbunden ist |
|
id
|
Inventory.sensors.id | string |
Sensor-ID |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
Name des Geräts, mit dem es verbunden ist, z. B. "Gateway 1" |
|
Kategorie
|
Inventory.sensors.category | string |
Sensorkategorie z.B. IRRADIANCE |
|
type
|
Inventory.sensors.type | string |
Sensortyp z. B. "Ebene der Arraystrahlung" |
|
gateways
|
Inventory.gateways | array of object |
Liste der Gateways für den angegebenen Standort |
|
name
|
Inventory.gateways.name | string |
Name des Wechselrichters z.B. Wechselrichter 1 |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
Die Gerätefirmwareversion |
|
SN
|
Inventory.gateways.SN | string |
Die Seriennummer der Geräte, z. B. 7F123456-00 |
|
Batterien
|
Inventory.batteries | array of object |
Liste der Batterien für den angegebenen Standort |
|
name
|
Inventory.batteries.name | string |
Der Akkuname |
|
manufacturer
|
Inventory.batteries.manufacturer | string |
Der Batteriehersteller |
|
Modell
|
Inventory.batteries.model | string |
Das Akkumodell |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
Die AkkufirmwareVersion |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– Seriennummer des Wechselrichters/ Gateways, an das die Batterie angeschlossen ist |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
die Kapazität des Akkus, wie vom Hersteller bereitgestellt |
|
SN
|
Inventory.batteries.SN | string |
Seriennummer des Akkus |
|
Wechselrichter
|
Inventory.inverters | array of object |
Liste der Wechselrichter für den angegebenen Standort |
|
name
|
Inventory.inverters.name | string |
Der Name des Wechselrichters |
|
manufacturer
|
Inventory.inverters.manufacturer | string |
Der Wechselrichterhersteller |
|
Modell
|
Inventory.inverters.model | string |
Das Wechselrichtermodell |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
Die Wechselrichter firmwareVersion |
|
SN
|
Inventory.inverters.SN | string |
Die Seriennummer des Wechselrichters |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Anzahl der Optimierer, die mit dem Wechselrichter verbunden sind |
Websiteliste
Gibt eine Liste von Websites zurück, die sich auf das angegebene Token beziehen, bei dem es sich um das Konto api_key handelt. Diese API akzeptiert Parameter für eine bequeme Suche, Sortierung und Paginierung.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
count
|
sites.count | integer |
Die Anzahl der zurückgegebenen Websites. |
|
Standort
|
sites.site | array of object |
Standort |
|
SiteID
|
sites.site.id | integer |
Die Website-ID. |
|
name
|
sites.site.name | string |
Der Websitename |
|
accountId
|
sites.site.accountId | integer |
Das Konto, zu dem diese Website gehört |
|
status
|
sites.site.status | string |
Der Websitestatus |
|
peakPower
|
sites.site.peakPower | float |
Spitzenleistung der Website |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Datum/Uhrzeit der letzten Aktualisierung der Website, Format jjjj-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
Datum und Uhrzeit der Standortinstallation, Format jjjj-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
Berechtigung zum Betriebsdatum |
|
Notizen
|
sites.site.notes | string |
Hinweise |
|
type
|
sites.site.type | string |
Websitetyp |
|
country
|
sites.site.location.country | string |
Das Land der Websites |
|
city
|
sites.site.location.city | string |
Die Stadt der Sehenswürdigkeiten |
|
address
|
sites.site.location.address | string |
Die Websiteadresse |
|
adresse2
|
sites.site.location.address2 | string |
Die Websiteadresse2 |
|
zip
|
sites.site.location.zip | string |
Die Websites zippen |
|
timeZone
|
sites.site.location.timeZone | string |
Die TimeZone der Websites |
|
Landesvorwahl
|
sites.site.location.countryCode | string |
Die Ländervorwahl der Websites |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
Primärer Modellherstellername |
|
modelName
|
sites.site.primaryModule.modelName | string |
Primärer Modellmodellname |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
Primäres Modell maximumPower |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
Primäres Modell temperaturCoef |
Websiteübersicht
Die Antwort umfasst die Stromkraft des Standorts, tägliche Energie, monatliche Energie, jährliche Energie und Lebenszeitenergie.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Websitebezeichner
|
site_id | True | integer |
Der Websitebezeichner |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energy
|
overview.lifeTimeData.energy | float |
Lebenszeitenergienummer |
|
energy
|
overview.lastYearData.energy | float |
Energienummer des letzten Jahres |
|
energy
|
overview.lastMonthData.energy | float |
Energienummer |
|
energy
|
overview.lastDayData.energy | float |
Energienummer des letzten Tages |
|
Macht
|
overview.currentPower.power | float |
Stromstromnummer |
|
measuredBy
|
overview.measuredBy | string |
Gemessen von |