SolarEdge (niezależny wydawca) (wersja zapoznawcza)
Łącznik SolarEdge zapewnia możliwość wyświetlania danych systemowych w innych aplikacjach
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Richard Wierenga |
| adres URL | https://knowledge-center.solaredge.com/ |
| rwconnectors@gmail.com |
| Metadane łącznika | |
|---|---|
| Publisher | Richard Wierenga |
| Witryna internetowa | https://www.solaredge.com/ |
| Zasady ochrony prywatności | https://monitoring.solaredge.com/solaredge-web/p/license |
| Kategorie | Internet rzeczy; Dane |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| klucz_api | securestring | Api_key dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Dane techniczne falownika |
Zwracanie określonych danych falownika dla danego przedziału czasu. |
| Dziennik zmian sprzętu |
Zwraca listę wymiany składników sprzętu uporządkowanych według daty. Ta metoda ma zastosowanie do falowników, optymalizatorów, baterii i bram. |
| Energia lokacji |
Zwracanie pomiarów energii lokacji |
| Energia lokacji — okres |
Zwróć całkowitą energię wytwarzaną przez dany okres. |
| Energia lokacji — szczegółowe |
Szczegółowe pomiary energii lokacji z mierników, takich jak zużycie, eksport (źródło danych), import (zakup) itp. |
| Informacje o magazynie |
Uzyskaj szczegółowe informacje o magazynowaniu z baterii: stan energii, energii i okresu istnienia energii. |
| Korzyści dla środowiska witryny |
Zwraca wszystkie korzyści środowiskowe w oparciu o produkcję energii na miejscu: emisje CO2 zapisane, równoważne drzewa posadzone i żarówki zasilane przez dzień. |
| Lista składników |
Zwraca listę falowników/smI w określonej lokacji |
| Lista witryn |
Zwraca listę witryn powiązanych z danym tokenem, który jest kontem api_key. Ten interfejs API akceptuje parametry wygodnego wyszukiwania, sortowania i stronicowania. |
| Moc witryny — szczegółowe |
Szczegółowe pomiary mocy lokacji z mierników, takich jak zużycie, eksport (źródło danych), import (zakup) itp. |
| Pobieranie danych mierników |
Zwraca dane dla każdego miernika w lokacji jego okres istnienia odczytu energii, metadanych i urządzenia, z którym jest połączony. |
| Pobieranie listy czujników |
Zwraca listę wszystkich czujników w lokacji oraz urządzenie, z którym są połączone |
| Przegląd witryny |
Odpowiedź obejmuje bieżącą moc lokacji, energię dzienną, energię miesięczną, energię roczną i energię w czasie życia. |
| Przepływ zasilania witryny |
Pobiera bieżący przepływ zasilania między wszystkimi elementami lokacji, w tym tablicą PV, magazynem (baterią), obciążeniami (zużyciem) i siecią. |
| Spis witryn |
Zwróć spis sprzętu SolarEdge w miejscu, w tym falowniki/SMI, baterie, mierniki, bramy i czujniki. |
| Szczegóły witryny |
Wyświetla szczegóły witryny, takie jak nazwa, lokalizacja, stan itp. |
| Zasilanie witryny |
Zwróć pomiary zasilania lokacji w rozdzielczości 15 minut |
Dane techniczne falownika
Zwracanie określonych danych falownika dla danego przedziału czasu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Numer seryjny sprzętu
|
equipment_id | True | string |
Numer seryjny sprzętu |
|
Początek (data i godzina) pobierania danych falownika
|
startTime | True | string |
Początek (data i godzina) pobierania danych falownika |
|
Koniec (data i godzina) pobierania danych falownika
|
endTime | True | string |
Koniec (data i godzina) pobierania danych falownika |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
data.count | integer |
Liczba odpowiedzi |
|
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 |
|
total (total)
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
total (total) |
|
temperatura
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Temperatura w stopniach Celsjusza |
|
falownikMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
Stan falownika, tj. OFF, STARTING, MPPT itp. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Liczba całkowita trybu operacyjnego 0 w siatce, 1 Działający w trybie pozasiadowym z pv lub baterii, 2 działające w trybie pozasiadowym z generatorem |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency | float |
acFrequency |
|
pozornePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower | integer |
pozornePower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.activePower | integer |
activePower |
|
reaktywnaPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reaktywnaPower |
|
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 |
|
pozornePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower | integer |
pozornePower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.activePower | integer |
activePower |
|
reaktywnaPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reaktywnaPower |
|
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 |
|
pozornePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower | integer |
pozornePower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.activePower | integer |
activePower |
|
reaktywnaPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reaktywnaPower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Dziennik zmian sprzętu
Zwraca listę wymiany składników sprzętu uporządkowanych według daty. Ta metoda ma zastosowanie do falowników, optymalizatorów, baterii i bram.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Numer seryjny sprzętu
|
equipment_id | True | string |
Numer seryjny sprzętu |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Krótki numer seryjny sprzętu |
|
numer części
|
ChangeLog.list.partNumber | string |
falownik/bateria/optymalizator/model bramy |
|
date
|
ChangeLog.list.date | string |
Data wymiany tego składnika sprzętu |
Energia lokacji
Zwracanie pomiarów energii lokacji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Stopień szczegółowości agregacji
|
timeUnit | True | string |
Stopień szczegółowości agregacji, dozwolone wartości to QUARTER_OF_AN_HOUR, GODZINA, DZIEŃ, TYDZIEŃ, MIESIĄC, ROK |
|
Data rozpoczęcia zwracania pomiaru energii
|
startDate | True | string |
Data rozpoczęcia zwracania pomiaru energii |
|
Końcowa data zwrotu energii
|
endDate | True | string |
Końcowa data zwrotu energii |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Żądana jednostka czasu |
|
jednostka
|
energy.unit | string |
Jednostki miary |
|
measuredBy
|
energy.measuredBy | string |
Źródło pomiarów |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Data i czas |
|
value
|
energy.values.value | float |
Mierzona moc (tj. wat) w określonej dacie/godzinie |
Energia lokacji — okres
Zwróć całkowitą energię wytwarzaną przez dany okres.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Data rozpoczęcia zwracania pomiaru energii
|
startDate | True | string |
Data rozpoczęcia zwracania pomiaru energii |
|
Końcowa data zwrotu energii
|
endDate | True | string |
Końcowa data zwrotu energii |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
energia
|
timeFrameEnergy.energy | float |
Podsumowanie energii |
|
jednostka
|
timeFrameEnergy.unit | string |
Jednostka energetyczna (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
Źródło pomiarów |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Podane informacje o dacie rozpoczęcia |
|
energia
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Data rozpoczęcia energii |
|
jednostka
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Jednostka daty rozpoczęcia (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Podane informacje o dacie zakończenia |
|
energia
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Data zakończenia energii |
|
jednostka
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Jednostka daty zakończenia (Wh) |
Energia lokacji — szczegółowe
Szczegółowe pomiary energii lokacji z mierników, takich jak zużycie, eksport (źródło danych), import (zakup) itp.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Stopień szczegółowości agregacji
|
timeUnit | True | string |
Stopień szczegółowości agregacji, dozwolone wartości to QUARTER_OF_AN_HOUR, GODZINA, DZIEŃ, TYDZIEŃ, MIESIĄC, ROK |
|
Czas rozpoczęcia mierzony przez energię w formacie rrrr-MM-DD hh:mm:ss
|
startTime | True | string |
Czas rozpoczęcia mierzony przez energię w formacie rrrr-MM-DD hh:mm:ss |
|
Czas zakończenia mierzonej energii w formacie rrrr-MM-DD hh:mm:ss
|
endTime | True | string |
Czas zakończenia mierzonej energii w formacie rrrr-MM-DD hh:mm:ss |
|
Wybierz tylko określone mierniki
|
Meters | True | string |
Wybierz tylko określone mierniki, jeśli zwracana jest pusta wartość wszystkiego. Dozwolone wartości to PRODUCTION, CONSUMPTION, SelfConsumption, FeedIn, Purchased |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Żądana jednostka czasu |
|
jednostka
|
energyDetails.unit | string |
Jednostki miary |
|
Metrów
|
energyDetails.meters | array of object |
Metrów |
|
typ
|
energyDetails.meters.type | string |
typ |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Data i czas |
|
value
|
energyDetails.meters.values.value | float |
Mierzona moc (tj. wat) w określonej dacie/godzinie |
Informacje o magazynie
Uzyskaj szczegółowe informacje o magazynowaniu z baterii: stan energii, energii i okresu istnienia energii.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Identyfikator witryny
|
startTime | True | string |
Identyfikator witryny |
|
Identyfikator witryny
|
endTime | True | string |
Identyfikator witryny |
|
Zwracanie danych tylko dla określonych numerów seryjnych baterii
|
serials | string |
Zwraca dane tylko dla określonych numerów seryjnych baterii, lista jest rozdzielona przecinkami. W przypadku pominięcia odpowiedź zawiera wszystkie baterie w miejscu |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
Liczba baterii w odpowiedzi |
|
Baterie
|
storageData.batteries | array of object |
Lista obiektów baterii |
|
Tabliczce znamionowej
|
storageData.batteries.nameplate | integer |
Tabliczka nazw (nominalna) baterii |
|
serialNumber
|
storageData.batteries.serialNumber | string |
Numer seryjny baterii |
|
modelNumber
|
storageData.batteries.modelNumber | string |
Numer modelu baterii |
|
telemetriaCount
|
storageData.batteries.telemetryCount | integer |
Liczba telemetrii dla tej baterii w odpowiedzi |
|
telemetrie
|
storageData.batteries.telemetries | array of object |
Lista telemetrii danych magazynu |
|
Sygnatury czasowej
|
storageData.batteries.telemetries.timeStamp | string |
Sygnatura czasowa telemetrii w formacie RRRR-MM-DD HH:MM:SS |
|
power
|
storageData.batteries.telemetries.power | integer |
Dodatnia moc wskazuje, że bateria jest ładowana, ujemna jest rozładowywanie |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Może być jednym z następujących wartości 0 (nieprawidłowy), 1 (wstrzymanie), 2 (termalne mgmt.), 3 (włączone), 4 (błąd) |
|
lifeTimeCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
Energia naładowana z baterii w Wh, w okresie eksploatacji baterii |
|
lifeTime EnergyDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
Energia rozładowana z baterii w Wh, w okresie eksploatacji baterii |
|
fullPackAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
Maksymalna energia (Wh), która może być obecnie przechowywana w baterii |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Temperatura wewnętrzna baterii w stopniach Celsjusza |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Ilość energii ac używanej do ładowania baterii z sieci w określonym zakresie dat w Wh |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
stan naładowania baterii jako procent dostępnej pojemności. Wartości znajdują się w zakresie od 0 do 100 |
Korzyści dla środowiska witryny
Zwraca wszystkie korzyści środowiskowe w oparciu o produkcję energii na miejscu: emisje CO2 zapisane, równoważne drzewa posadzone i żarówki zasilane przez dzień.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Jednostek
|
envBenefits.gasEmissionSaved.units | string |
jednostki dla pozostałych wyników |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 w kg lub lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 w kg lub lb |
|
Nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX w kg lub lb |
|
drzewaPlanowane
|
envBenefits.treesPlanted | float |
Równoważne sadzenia nowych drzew w celu zmniejszenia poziomu CO2 |
|
Żarówek
|
envBenefits.lightBulbs | float |
liczba żarówek, które mogły być zasilane przez witrynę przez dzień |
Lista składników
Zwraca listę falowników/smI w określonej lokacji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
reporters.count | integer |
Liczba składników lokacji |
|
list
|
reporters.list | array of object |
list |
|
nazwa składnika
|
reporters.list.componentname | string |
Nazwa składnika |
|
producent
|
reporters.list.manufacturer | string |
Producent składnika |
|
Model
|
reporters.list.Model | string |
Model składników |
|
SerialNumber
|
reporters.list.SerialNumber | string |
Numer seryjny składnika |
Lista witryn
Zwraca listę witryn powiązanych z danym tokenem, który jest kontem api_key. Ten interfejs API akceptuje parametry wygodnego wyszukiwania, sortowania i stronicowania.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
sites.count | integer |
Ilość zwracanych witryn. |
|
witryna
|
sites.site | array of object |
witryna |
|
Identyfikator witryny
|
sites.site.id | integer |
Identyfikator witryny. |
|
nazwa
|
sites.site.name | string |
Nazwa witryny |
|
accountId
|
sites.site.accountId | integer |
Konto, do którego należy ta witryna |
|
stan
|
sites.site.status | string |
Stan witryny |
|
peakPower
|
sites.site.peakPower | float |
Moc szczytowa lokacji |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Data/godzina ostatniej aktualizacji witryny, format rrrr-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
Data/godzina instalacji lokacji, format rrrr-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
Uprawnienie do działania daty |
|
Notatki
|
sites.site.notes | string |
Notatki |
|
typ
|
sites.site.type | string |
Typ witryny |
|
country
|
sites.site.location.country | string |
Kraj witryn |
|
city
|
sites.site.location.city | string |
Miasto |
|
address
|
sites.site.location.address | string |
Adres witryn |
|
adres2
|
sites.site.location.address2 | string |
Adres lokacji2 |
|
zip
|
sites.site.location.zip | string |
Plik zip witryn |
|
strefa czasowa
|
sites.site.location.timeZone | string |
Strefa czasowa witryn |
|
Kod kraju
|
sites.site.location.countryCode | string |
Kod kraju witryn |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
Nazwa producenta podstawowego modelu |
|
modelName
|
sites.site.primaryModule.modelName | string |
Nazwa modelu podstawowego |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
Maksymalna wartość modelu podstawowegoPower |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
Temperatura modelu podstawowegoKoef |
Moc witryny — szczegółowe
Szczegółowe pomiary mocy lokacji z mierników, takich jak zużycie, eksport (źródło danych), import (zakup) itp.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Czas rozpoczęcia mierzonej energii
|
startTime | True | string |
Czas rozpoczęcia mierzony przez energię w formacie rrrr-MM-DD hh:mm:ss |
|
Czas zakończenia mierzonej energii
|
endTime | True | string |
Czas zakończenia mierzonej energii w formacie rrrr-MM-DD hh:mm:ss |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Żądana jednostka czasu |
|
jednostka
|
powerDetails.unit | string |
Jednostki pomiarów |
|
Metrów
|
powerDetails.meters | array of object |
Mierniki |
|
typ
|
powerDetails.meters.type | string |
Typ miernika (Production/Consumption/SelfConsumption/FeedIn (eksport)/Purchased(import)) |
|
values
|
powerDetails.meters.values | array of object |
Pary daty i mocy dla każdej daty |
|
date
|
powerDetails.meters.values.date | string |
Data i czas |
|
value
|
powerDetails.meters.values.value | float |
Zasilanie dla określonej daty/godziny |
Pobieranie danych mierników
Zwraca dane dla każdego miernika w lokacji jego okres istnienia odczytu energii, metadanych i urządzenia, z którym jest połączony.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
|
Stopień szczegółowości agregacji
|
timeUnit | string |
Stopień szczegółowości agregacji, dozwolone wartości to QUARTER_OF_AN_HOUR, GODZINA, DZIEŃ, TYDZIEŃ, MIESIĄC, ROK |
|
|
Czas rozpoczęcia mierzony przez energię w formacie rrrr-MM-DD hh:mm:ss
|
startTime | True | string |
Czas rozpoczęcia mierzony przez energię w formacie rrrr-MM-DD hh:mm:ss |
|
Czas zakończenia mierzonej energii w formacie rrrr-MM-DD hh:mm:ss
|
endTime | True | string |
Czas zakończenia mierzonej energii w formacie rrrr-MM-DD hh:mm:ss |
|
Wybierz tylko określone mierniki
|
meters | string |
Wybierz tylko określone mierniki. Jeśli ta wartość zostanie pominięta, zwracane są wszystkie odczyty mierników. Dozwolone wartości to Production, Consumption, FeedIn, Purchased |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Stopień szczegółowości agregacji |
|
jednostka
|
meterEnergyDetails.unit | string |
Zwrócona jednostka mierników (Wh) |
|
Metrów
|
meterEnergyDetails.meters | array of object |
Wartości na miernik |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Falownik, z którym jest podłączony miernik |
|
model
|
meterEnergyDetails.meters.model | string |
Model miernika |
|
meterType
|
meterEnergyDetails.meters.meterType | string |
Typ miernika Produkcja, Zużycie, FeedIn lub Zakupione |
|
values
|
meterEnergyDetails.meters.values | array of object |
Wartości na miernik na datę |
|
date
|
meterEnergyDetails.meters.values.date | string |
Sygnatura czasowa miary |
|
value
|
meterEnergyDetails.meters.values.value | float |
Odczyt energii dożywotni |
Pobieranie listy czujników
Zwraca listę wszystkich czujników w lokacji oraz urządzenie, z którym są połączone
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
Liczba czujników lokacji |
|
list
|
SiteSensors.list | array of object |
Lista na bramę |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Nazwa bramy, z która jest połączona z czujnikiem |
|
count
|
SiteSensors.list.count | integer |
Liczba czujników bram |
|
Czujniki
|
SiteSensors.list.sensors | array of object |
Czujniki |
|
nazwa
|
SiteSensors.list.sensors.name | string |
Nazwa czujnika |
|
miara
|
SiteSensors.list.sensors.measurement | string |
Co mierzy czujnik, np. SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
typ
|
SiteSensors.list.sensors.type | string |
pomiary czujnika, np. SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Przegląd witryny
Odpowiedź obejmuje bieżącą moc lokacji, energię dzienną, energię miesięczną, energię roczną i energię w czasie życia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energia
|
overview.lifeTimeData.energy | float |
Numer energii okresu istnienia |
|
energia
|
overview.lastYearData.energy | float |
Zeszłoroczny numer energii |
|
energia
|
overview.lastMonthData.energy | float |
Liczba energii |
|
energia
|
overview.lastDayData.energy | float |
Numer energii ostatniego dnia |
|
power
|
overview.currentPower.power | float |
Bieżący numer zasilania |
|
measuredBy
|
overview.measuredBy | string |
Mierzone przez |
Przepływ zasilania witryny
Pobiera bieżący przepływ zasilania między wszystkimi elementami lokacji, w tym tablicą PV, magazynem (baterią), obciążeniami (zużyciem) i siecią.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
jednostka
|
siteCurrentPowerFlow.unit | string |
Jednostki miary (np. Watt) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
Tabela zawierająca wszystkie relacje między elementami i kierunek przepływu zasilania (element produkcji i element zużywający) |
|
z
|
siteCurrentPowerFlow.connections.from | string |
Element dostarczający moc |
|
na
|
siteCurrentPowerFlow.connections.to | string |
Element zużywa energię |
|
stan
|
siteCurrentPowerFlow.GRID.status | string |
Stan siatki (aktywny/bezczynny/wyłączony) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
bieżąca siatka zasilania |
|
stan
|
siteCurrentPowerFlow.LOAD.status | string |
Stan ładowania (aktywny/bezczynny/wyłączony) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
bieżące obciążenie zasilania |
|
stan
|
siteCurrentPowerFlow.PV.status | string |
Stan PV (aktywny/bezczynny/wyłączony) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
bieżąca moc PV |
|
stan
|
siteCurrentPowerFlow.STORAGE.status | string |
Stan magazynu (aktywny/bezczynny/wyłączony) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
bieżąca moc magazynu |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
Opłata za magazynDokład |
|
krytyczny
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
Krytyczne dla magazynu? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
W trybie tworzenia kopii zapasowej określony czas przed upływem miejsca do magazynowania |
Spis witryn
Zwróć spis sprzętu SolarEdge w miejscu, w tym falowniki/SMI, baterie, mierniki, bramy i czujniki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Metrów
|
Inventory.meters | array of object |
Lista mierników dla określonej lokacji |
|
nazwa
|
Inventory.meters.name | string |
Nazwa miernika |
|
producent
|
Inventory.meters.manufacturer | string |
Producent miernika |
|
model
|
Inventory.meters.model | string |
Model miernika |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
Wersja oprogramowania układowego miernika |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– Nazwa urządzenia SolarEdge, do których jest podłączony miernik |
|
typ
|
Inventory.meters.type | string |
Typ miernika, np. "Produkcja" |
|
formularz
|
Inventory.meters.form | string |
fizyczny dla miernika HW lub wirtualnego, jeśli jest obliczany przez arytmetyczne między innymi miernikami |
|
Czujniki
|
Inventory.sensors | array of object |
Lista czujników dla określonej lokacji |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– Nazwa urządzenia SolarEdge, z które jest podłączony czujnik |
|
id
|
Inventory.sensors.id | string |
Identyfikator czujnika |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
nazwa urządzenia, z który jest połączony, np. "Brama 1" |
|
kategoria
|
Inventory.sensors.category | string |
Kategoria czujników, np. IRRADIANCE |
|
typ
|
Inventory.sensors.type | string |
Typ czujnika, np. "Płaszczyzna irradiance tablicy" |
|
gateways
|
Inventory.gateways | array of object |
Lista bram dla określonej lokacji |
|
nazwa
|
Inventory.gateways.name | string |
Nazwa falownika, np. Falownik 1 |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
Wersja oprogramowania układowego sprzętu |
|
SN
|
Inventory.gateways.SN | string |
Numer seryjny sprzętu, np. 7F123456-00 |
|
Baterie
|
Inventory.batteries | array of object |
Lista baterii dla określonej lokacji |
|
nazwa
|
Inventory.batteries.name | string |
Nazwa baterii |
|
producent
|
Inventory.batteries.manufacturer | string |
Producent baterii |
|
model
|
Inventory.batteries.model | string |
Model baterii |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
Wersja oprogramowania układowego baterii |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– numer seryjny falownika/bramy, z |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
pojemność baterii na tablicy nazw dostarczonej przez producenta |
|
SN
|
Inventory.batteries.SN | string |
Numer seryjny baterii |
|
Falowniki
|
Inventory.inverters | array of object |
Lista falowników dla określonej lokacji |
|
nazwa
|
Inventory.inverters.name | string |
Nazwa falownika |
|
producent
|
Inventory.inverters.manufacturer | string |
Producent falownika |
|
model
|
Inventory.inverters.model | string |
Model falownika |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
FirmwareVersion falownika |
|
SN
|
Inventory.inverters.SN | string |
Numer seryjny falownika |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Liczba optymalizatorów podłączonych do falownika |
Szczegóły witryny
Wyświetla szczegóły witryny, takie jak nazwa, lokalizacja, stan itp.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
details.id | integer |
Identyfikator witryny |
|
nazwa
|
details.name | string |
Nazwa witryny |
|
accountId
|
details.accountId | integer |
Konto, do którego należy ta witryna |
|
stan
|
details.status | string |
Stan witryn |
|
peakPower
|
details.peakPower | float |
Witryna szczytowaPower |
|
waluta
|
details.currency | string |
Waluta witryn |
|
installationDate
|
details.installationDate | string |
Data/godzina instalacji lokacji, format rrrr-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
Uprawnienie do działania daty |
|
Notatki
|
details.notes | string |
Notatki |
|
typ
|
details.type | string |
Typ witryny |
|
country
|
details.location.country | string |
Kraj witryn |
|
city
|
details.location.city | string |
Miasto |
|
address
|
details.location.address | string |
Adres witryn |
|
adres2
|
details.location.address2 | string |
Adres lokacji2 |
|
zip
|
details.location.zip | string |
Plik zip witryn |
|
strefa czasowa
|
details.location.timeZone | string |
Strefa czasowa witryn |
|
Kod kraju
|
details.location.countryCode | string |
Kod kraju witryn |
|
alertQuantity
|
details.alertQuantity | integer |
Liczba otwartych alertów w tej witrynie |
|
alertYeverity
|
details.alertSeverity | string |
Najwyższa ważność alertu w tej witrynie |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
Identyfikator URI obrazu witryn |
Zasilanie witryny
Zwróć pomiary zasilania lokacji w rozdzielczości 15 minut
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Data i godzina rozpoczęcia
|
startTime | True | string |
Data i godzina rozpoczęcia (rrrr-mm-dd hh:mm:ss) w celu uzyskania pomiarów mocy |
|
Data i godzina rozpoczęcia
|
endTime | True | string |
Data i godzina rozpoczęcia (rrrr-mm-dd hh:mm:ss) w celu uzyskania pomiarów mocy |
|
Identyfikator witryny
|
site_id | True | integer |
Identyfikator witryny |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Jednostka czasowa (tj. QUARTER_OF_AN_HOUR) |
|
jednostka
|
power.unit | string |
Jednostka miary (tj. wat) |
|
measuredBy
|
power.measuredBy | string |
Źródło pomiarów |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Data i czas |
|
value
|
power.values.value | float |
Mierzona moc (tj. wat) w określonej dacie/godzinie |