SolarEdge (независимый издатель) (предварительная версия)
Соединитель SolarEdge предоставляет оппуртность для отображения системных данных в других приложениях.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Ричард Wierenga |
| URL | https://knowledge-center.solaredge.com/ |
| Адрес электронной почты | rwconnectors@gmail.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Ричард Wierenga |
| Веб-сайт | https://www.solaredge.com/ |
| Политика конфиденциальности | https://monitoring.solaredge.com/solaredge-web/p/license |
| Категории | Интернет вещей; Данные |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| ключ API | securestring | Api_key для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Power сайта — подробные сведения |
Подробные измерения мощности сайта с таких счетчиков, как потребление, экспорт (веб-канал), импорт (покупка) и т. д. |
| Site Energy — подробно |
Подробные измерения энергии сайта от счетчиков, таких как потребление, экспорт (веб-канал), импорт (покупка) и т. д. |
| Журнал изменений оборудования |
Возвращает список замен компонентов оборудования, упорядоченных по дате. Этот метод применим к инверторам, оптимизаторам, батареям и шлюзам. |
| Инвентаризация сайтов |
Верните инвентаризацию оборудования SolarEdge на сайте, включая инвертеры/SMIs, батареи, счетчики, шлюзы и датчики. |
| Мощность сайта |
Возврат измерений мощности сайта за 15 минут |
| Обзор сайта |
Ответ включает в себя текущую мощность сайта, ежедневную энергию, ежемесячную энергию, годовую энергию и энергию времени жизни. |
| Получение данных счетчиков |
Возвращает для каждого счетчика на сайте его чтение энергии, метаданные и устройство, к которому он подключен. |
| Получение списка датчиков |
Возвращает список всех датчиков на сайте и устройство, к которому они подключены. |
| Поток питания сайта |
Извлекает текущий поток питания между всеми элементами сайта, включая массив PV, хранилище (батарею), нагрузки (потребление) и сетку. |
| Преимущества среды сайта |
Возвращает все экологические преимущества на основе производства энергии на месте: выбросы CO2, сохраненные, эквивалентные деревья, и лампочки, питаемые в течение дня. |
| Сведения о сайте |
Отображает сведения о сайте, такие как имя, расположение, состояние и т. д. |
| Сведения о хранилище |
Получите подробные сведения о хранении от батарей: состояние энергии, энергии и времени существования энергии. |
| Список компонентов |
Возврат списка инверторов или SMIs на определенном сайте |
| Список сайтов |
Возвращает список сайтов, связанных с заданным токеном, который является учетной записью api_key. Этот API принимает параметры для удобного поиска, сортировки и разбиения на страницы. |
| Технические данные инвертера |
Возвращает определенные инвертерные данные для заданного интервала времени. |
| Энергия сайта |
Возврат измерений энергии сайта |
| Энергия сайта — период времени |
Возвращает общую энергию сайта, произведенную в течение заданного периода. |
Power сайта — подробные сведения
Подробные измерения мощности сайта с таких счетчиков, как потребление, экспорт (веб-канал), импорт (покупка) и т. д.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Время начала измерения энергии
|
startTime | True | string |
Время начала измерения энергии в формате гггг-MM-DD чч:мм:сс |
|
Время окончания измерения энергии
|
endTime | True | string |
Время окончания измерения энергии в формате гггг-MM-DD чч:мм:сс |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Запрошенная единица времени |
|
единица
|
powerDetails.unit | string |
Единицы измерений |
|
Метров
|
powerDetails.meters | array of object |
Счетчики |
|
type
|
powerDetails.meters.type | string |
Тип измерения (Production/Consumption/SelfConsumption/FeedIn (экспорт)/Purchased(import)) |
|
values
|
powerDetails.meters.values | array of object |
Пары дат и мощности для каждой даты |
|
date
|
powerDetails.meters.values.date | string |
Дата и время |
|
value
|
powerDetails.meters.values.value | float |
Питание для указанной даты и времени |
Site Energy — подробно
Подробные измерения энергии сайта от счетчиков, таких как потребление, экспорт (веб-канал), импорт (покупка) и т. д.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Степень детализации агрегирования
|
timeUnit | True | string |
Степень детализации агрегирования, допустимые значения: QUARTER_OF_AN_HOUR, ЧАС, ДЕНЬ, НЕДЕЛЯ, МЕСЯЦ, ГОД |
|
Время начала измерения энергии в формате гггг-MM-DD чч:мм:сс
|
startTime | True | string |
Время начала измерения энергии в формате гггг-MM-DD чч:мм:сс |
|
Время окончания измерения энергии в формате гггг-MM-DD чч:мм:сс
|
endTime | True | string |
Время окончания измерения энергии в формате гггг-MM-DD чч:мм:сс |
|
Выбор только определенных счетчиков
|
Meters | True | string |
Выберите только определенные счетчики, если возвращается пустое значение. Допустимые значения: PRODUCTION, CONSUMPTION, SelfConsumption, FeedIn, Purchased |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Запрошенная единица времени |
|
единица
|
energyDetails.unit | string |
Единицы измерения |
|
Метров
|
energyDetails.meters | array of object |
Метров |
|
type
|
energyDetails.meters.type | string |
type |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Дата и время |
|
value
|
energyDetails.meters.values.value | float |
Измеряемая мощность (т. е. Уотт) в указанное время |
Журнал изменений оборудования
Возвращает список замен компонентов оборудования, упорядоченных по дате. Этот метод применим к инверторам, оптимизаторам, батареям и шлюзам.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Серийный номер оборудования
|
equipment_id | True | string |
Серийный номер оборудования |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Короткий серийный номер оборудования |
|
номер детали
|
ChangeLog.list.partNumber | string |
inverter/battery/optimizer/gateway model |
|
date
|
ChangeLog.list.date | string |
Дата замены этого компонента оборудования |
Инвентаризация сайтов
Верните инвентаризацию оборудования SolarEdge на сайте, включая инвертеры/SMIs, батареи, счетчики, шлюзы и датчики.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Метров
|
Inventory.meters | array of object |
Список метров для указанного сайта |
|
имя
|
Inventory.meters.name | string |
Имя счетчика |
|
manufacturer
|
Inventory.meters.manufacturer | string |
Производитель счетчиков |
|
model
|
Inventory.meters.model | string |
Модель измерения |
|
встроенное ПОVersion
|
Inventory.meters.firmwareVersion | string |
Измерение встроенного ПОVersion |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
— Имя устройства SolarEdge, к которому подключен счетчик |
|
type
|
Inventory.meters.type | string |
Тип измерения, например "Production" |
|
форма
|
Inventory.meters.form | string |
физический для счетчика HW или виртуального, если вычисляется арифметикой между другими счетчиками |
|
Интернета вещей
|
Inventory.sensors | array of object |
Список датчиков для указанного сайта |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
— Имя устройства SolarEdge, к которому подключен датчик |
|
id
|
Inventory.sensors.id | string |
Идентификатор датчика |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
имя устройства, к которому он подключен, например "Шлюз 1" |
|
категория
|
Inventory.sensors.category | string |
Категория датчика, например IRRADIANCE |
|
type
|
Inventory.sensors.type | string |
Тип датчика, например "Плоскость массива иррадиация" |
|
gateways
|
Inventory.gateways | array of object |
Список шлюзов для указанного сайта |
|
имя
|
Inventory.gateways.name | string |
Имя инвертатора, например Inverter 1 |
|
встроенное ПОVersion
|
Inventory.gateways.firmwareVersion | string |
Встроенное ПО оборудования |
|
SN
|
Inventory.gateways.SN | string |
Серийный номер оборудования, например 7F123456-00 |
|
Батареи
|
Inventory.batteries | array of object |
Список батарей для указанного сайта |
|
имя
|
Inventory.batteries.name | string |
Имя батареи |
|
manufacturer
|
Inventory.batteries.manufacturer | string |
Производитель батареи |
|
model
|
Inventory.batteries.model | string |
Модель батареи |
|
встроенное ПОVersion
|
Inventory.batteries.firmwareVersion | string |
Встроенное ПО батареи |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
— серийный номер инвертатора или шлюза, к которому подключена батарея. |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
емкость заряда батареи, предоставленной производителем |
|
SN
|
Inventory.batteries.SN | string |
Серийный номер батареи |
|
Инверторы
|
Inventory.inverters | array of object |
Список инверторов для указанного сайта |
|
имя
|
Inventory.inverters.name | string |
Имя инвертера |
|
manufacturer
|
Inventory.inverters.manufacturer | string |
Производитель инвертатора |
|
model
|
Inventory.inverters.model | string |
Модель инвертатора |
|
встроенное ПОVersion
|
Inventory.inverters.firmwareVersion | string |
Инвертатор встроенного ПОVersion |
|
SN
|
Inventory.inverters.SN | string |
Порядковый номер инвертера |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Число оптимизаторов, подключенных к инвертатору |
Мощность сайта
Возврат измерений мощности сайта за 15 минут
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дата и время начала
|
startTime | True | string |
Дата начала и время (гггг-mm-dd чч:мм:сс) для получения измерений питания |
|
Дата и время начала
|
endTime | True | string |
Дата начала и время (гггг-mm-dd чч:мм:сс) для получения измерений питания |
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Единица времени (т. е. QUARTER_OF_AN_HOUR) |
|
единица
|
power.unit | string |
Единица измерения (т. е. Уотт) |
|
measuredBy
|
power.measuredBy | string |
Источник измерений |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Дата и время |
|
value
|
power.values.value | float |
Измеряемая мощность (т. е. Уотт) в указанное время |
Обзор сайта
Ответ включает в себя текущую мощность сайта, ежедневную энергию, ежемесячную энергию, годовую энергию и энергию времени жизни.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energy
|
overview.lifeTimeData.energy | float |
Число энергии времени существования |
|
energy
|
overview.lastYearData.energy | float |
В прошлом году номер энергии |
|
energy
|
overview.lastMonthData.energy | float |
Номер энергии |
|
energy
|
overview.lastDayData.energy | float |
Последнее число энергии в последний день |
|
power
|
overview.currentPower.power | float |
Текущий номер питания |
|
measuredBy
|
overview.measuredBy | string |
Измеряется по |
Получение данных счетчиков
Возвращает для каждого счетчика на сайте его чтение энергии, метаданные и устройство, к которому он подключен.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Степень детализации агрегирования
|
timeUnit | string |
Степень детализации агрегирования, допустимые значения: QUARTER_OF_AN_HOUR, ЧАС, ДЕНЬ, НЕДЕЛЯ, МЕСЯЦ, ГОД |
|
|
Время начала измерения энергии в формате гггг-MM-DD чч:мм:сс
|
startTime | True | string |
Время начала измерения энергии в формате гггг-MM-DD чч:мм:сс |
|
Время окончания измерения энергии в формате гггг-MM-DD чч:мм:сс
|
endTime | True | string |
Время окончания измерения энергии в формате гггг-MM-DD чч:мм:сс |
|
Выбор только определенных счетчиков
|
meters | string |
Выберите только определенные счетчики. Если это значение опущено, возвращаются все значения счетчиков. Допустимые значения: Production, Consumption, FeedIn, Purchased |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Степень детализации агрегирования |
|
единица
|
meterEnergyDetails.unit | string |
Возвращаемый единица измерения (Wh) |
|
Метров
|
meterEnergyDetails.meters | array of object |
Значения на единицу измерения |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Инвертер, к которому подключен счетчик |
|
model
|
meterEnergyDetails.meters.model | string |
Модель измерения |
|
meterType
|
meterEnergyDetails.meters.meterType | string |
Тип единицы измерения, потребление, feedIn или приобретенный |
|
values
|
meterEnergyDetails.meters.values | array of object |
Значения на метр на дату |
|
date
|
meterEnergyDetails.meters.values.date | string |
Метка времени измерения |
|
value
|
meterEnergyDetails.meters.values.value | float |
Чтение энергии времени существования |
Получение списка датчиков
Возвращает список всех датчиков на сайте и устройство, к которому они подключены.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
Количество датчиков сайтов |
|
list
|
SiteSensors.list | array of object |
Список на шлюз |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Имя шлюза, к которому подключен датчик |
|
count
|
SiteSensors.list.count | integer |
Количество датчиков шлюзов |
|
Интернета вещей
|
SiteSensors.list.sensors | array of object |
Интернета вещей |
|
имя
|
SiteSensors.list.sensors.name | string |
Имя датчика |
|
измерение
|
SiteSensors.list.sensors.measurement | string |
Какие меры датчика, например SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
type
|
SiteSensors.list.sensors.type | string |
меры датчика, например SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Поток питания сайта
Извлекает текущий поток питания между всеми элементами сайта, включая массив PV, хранилище (батарею), нагрузки (потребление) и сетку.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
единица
|
siteCurrentPowerFlow.unit | string |
Единицы измерения (например, Уотт) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
Таблица, включая все связи между элементами, и направления потока питания (производство элемента и элемент потребления) |
|
от / из / с (context-dependent)
|
siteCurrentPowerFlow.connections.from | string |
Элемент, предоставляющий питание |
|
Кому
|
siteCurrentPowerFlow.connections.to | string |
Элемент, потребляющий мощность |
|
статус
|
siteCurrentPowerFlow.GRID.status | string |
Состояние сетки (активный или бездействуемый или отключенный) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
текущая сетка Power |
|
статус
|
siteCurrentPowerFlow.LOAD.status | string |
Состояние загрузки (активный или бездействуемый или отключенный) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
текущая загрузка Power |
|
статус
|
siteCurrentPowerFlow.PV.status | string |
Состояние PV (активный или бездействуемый или отключенный) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
текущая мощность PV |
|
статус
|
siteCurrentPowerFlow.STORAGE.status | string |
Состояние хранилища (активный или бездействуемый или отключенный) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
текущая мощность хранилища |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
Плата за хранение |
|
критический
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
Критически важное хранилище? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
В режиме резервного копирования указанное время до истечения срока хранения |
Преимущества среды сайта
Возвращает все экологические преимущества на основе производства энергии на месте: выбросы CO2, сохраненные, эквивалентные деревья, и лампочки, питаемые в течение дня.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Единиц
|
envBenefits.gasEmissionSaved.units | string |
единицы для остальных результатов |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 в Кг или Lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 в Кг или Lb |
|
nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX в кг или lb |
|
treesPlanted
|
envBenefits.treesPlanted | float |
Эквивалентное посадка новых деревьев для снижения уровня CO2 |
|
Лампочки
|
envBenefits.lightBulbs | float |
количество лампочек, которые могли бы быть питанием сайта в течение дня |
Сведения о сайте
Отображает сведения о сайте, такие как имя, расположение, состояние и т. д.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
details.id | integer |
Идентификатор сайта |
|
имя
|
details.name | string |
Имя сайта |
|
accountId
|
details.accountId | integer |
Учетная запись, к которой принадлежит этот сайт |
|
статус
|
details.status | string |
Состояние сайтов |
|
пиковая мощность
|
details.peakPower | float |
Сайты пиковая мощность |
|
currency
|
details.currency | string |
Валюта сайтов |
|
installationDate
|
details.installationDate | string |
Дата установки сайта, формат гггг-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
Разрешение на работу даты |
|
заметки
|
details.notes | string |
Примечания. |
|
type
|
details.type | string |
Тип сайта |
|
country
|
details.location.country | string |
Страна сайтов |
|
city
|
details.location.city | string |
Город сайтов |
|
address
|
details.location.address | string |
Адрес сайтов |
|
Адрес2
|
details.location.address2 | string |
Адрес сайтов2 |
|
ZIP-архив
|
details.location.zip | string |
Zip-файл сайтов |
|
часовой пояс
|
details.location.timeZone | string |
Часовой пояс сайтов |
|
код страны
|
details.location.countryCode | string |
Код страны сайтов |
|
alertQuantity
|
details.alertQuantity | integer |
Количество открытых оповещений на этом сайте |
|
alertSeverity
|
details.alertSeverity | string |
Высокий уровень серьезности оповещений на этом сайте |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
Универсальный код ресурса (URI) образа сайтов |
Сведения о хранилище
Получите подробные сведения о хранении от батарей: состояние энергии, энергии и времени существования энергии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Идентификатор сайта
|
startTime | True | string |
Идентификатор сайта |
|
Идентификатор сайта
|
endTime | True | string |
Идентификатор сайта |
|
Возврат данных только для определенных серийных номеров батареи
|
serials | string |
Возвращает данные только для определенных серийных номеров батареи, список разделен запятыми. Если опущено, ответ включает все батареи на сайте |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
Количество батарей, включаемых в ответ |
|
Батареи
|
storageData.batteries | array of object |
Список объектов батареи |
|
паспортная табличка
|
storageData.batteries.nameplate | integer |
Емкость заряда (номинальной) батареи |
|
serialNumber
|
storageData.batteries.serialNumber | string |
Серийный номер батареи |
|
номер модели
|
storageData.batteries.modelNumber | string |
Номер модели батареи |
|
telemetryCount
|
storageData.batteries.telemetryCount | integer |
Количество телеметрий для этой батареи в ответе |
|
данные телеметрии
|
storageData.batteries.telemetries | array of object |
Список данных хранения данных телеметрии |
|
Метка времени
|
storageData.batteries.telemetries.timeStamp | string |
Метка времени телеметрии в формате ггГГ-MM-DD HH:MM:SS |
|
power
|
storageData.batteries.telemetries.power | integer |
Положительное питание указывает, что заряд батареи, отрицательный выгрузка |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Может быть одним из следующих 0 (недопустимых), 1 (резервный), 2 (тепловая мгмт.), 3 (включено), 4 (ошибка) |
|
lifeTimeCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
Энергия, заряжаемая от батареи в Wh, во время существования батареи |
|
lifeTimeDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
Энергия, выряжаемая из батареи в Wh, во время существования батареи |
|
fullPackAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
Максимальная энергия (Wh), которая в настоящее время может храниться в батарее |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Внутренняя температура батареи в Цельсиях |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Объем энергии AC, используемый для заряда батареи из сетки в заданном диапазоне дат в Wh |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
состояние заряда батареи в процентах от доступной емкости. Значения находятся в диапазоне от 0 до 100 |
Список компонентов
Возврат списка инверторов или SMIs на определенном сайте
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
count
|
reporters.count | integer |
Количество компонентов сайтов |
|
list
|
reporters.list | array of object |
list |
|
Имя компонента
|
reporters.list.componentname | string |
Имя компонента |
|
manufacturer
|
reporters.list.manufacturer | string |
Производитель компонентов |
|
Модель
|
reporters.list.Model | string |
Модель компонента |
|
Серийный номер
|
reporters.list.SerialNumber | string |
Серийный номер компонента |
Список сайтов
Возвращает список сайтов, связанных с заданным токеном, который является учетной записью api_key. Этот API принимает параметры для удобного поиска, сортировки и разбиения на страницы.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
count
|
sites.count | integer |
Количество возвращаемых сайтов. |
|
сайт
|
sites.site | array of object |
сайт |
|
SiteID
|
sites.site.id | integer |
Идентификатор сайта. |
|
имя
|
sites.site.name | string |
Имя сайта |
|
accountId
|
sites.site.accountId | integer |
Учетная запись, к которой принадлежит этот сайт |
|
статус
|
sites.site.status | string |
Состояние сайта |
|
пиковая мощность
|
sites.site.peakPower | float |
Пиковая мощность сайта |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Дата последнего обновления сайта, формат гггг-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
Дата установки сайта, формат гггг-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
Разрешение на работу даты |
|
заметки
|
sites.site.notes | string |
Примечания. |
|
type
|
sites.site.type | string |
Тип сайта |
|
country
|
sites.site.location.country | string |
Страна сайтов |
|
city
|
sites.site.location.city | string |
Город сайтов |
|
address
|
sites.site.location.address | string |
Адрес сайтов |
|
Адрес2
|
sites.site.location.address2 | string |
Адрес сайтов2 |
|
ZIP-архив
|
sites.site.location.zip | string |
Zip-файл сайтов |
|
часовой пояс
|
sites.site.location.timeZone | string |
Часовой пояс сайтов |
|
код страны
|
sites.site.location.countryCode | string |
Код страны сайтов |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
Имя производителя основной модели |
|
modelName
|
sites.site.primaryModule.modelName | string |
Имя модели основной модели |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
Максимальная мощность основной модели |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
Температура основной модели |
Технические данные инвертера
Возвращает определенные инвертерные данные для заданного интервала времени.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Серийный номер оборудования
|
equipment_id | True | string |
Серийный номер оборудования |
|
Начало (дата и время) для получения данных инвертера
|
startTime | True | string |
Начало (дата и время) для получения данных инвертера |
|
Конец (дата и время) для получения данных инвертера
|
endTime | True | string |
Конец (дата и время) для получения данных инвертера |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
count
|
data.count | integer |
Количество ответов |
|
данные телеметрии
|
data.telemetries | array of object |
данные телеметрии |
|
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
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
total |
|
Температура
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Температура в Цельсиях |
|
inverterMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
Состояние инвертатора, т. е. OFF, STARTING, MPPT и т. д. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Целое число операций 0 в сетке, 1 Работа в режиме вне сетки с PV или батареей, 2, работающая в режиме вне сетки с генератором |
|
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 |
|
реактивная мощность
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
реактивная мощность |
|
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 |
|
реактивная мощность
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
реактивная мощность |
|
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 |
|
реактивная мощность
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
реактивная мощность |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Энергия сайта
Возврат измерений энергии сайта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Степень детализации агрегирования
|
timeUnit | True | string |
Степень детализации агрегирования, допустимые значения: QUARTER_OF_AN_HOUR, ЧАС, ДЕНЬ, НЕДЕЛЯ, МЕСЯЦ, ГОД |
|
Дата начала для возврата измерения энергии
|
startDate | True | string |
Дата начала для возврата измерения энергии |
|
Значение даты окончания измерения энергии
|
endDate | True | string |
Значение даты окончания измерения энергии |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Запрошенная единица времени |
|
единица
|
energy.unit | string |
Единицы измерения |
|
measuredBy
|
energy.measuredBy | string |
Источник измерений |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Дата и время |
|
value
|
energy.values.value | float |
Измеряемая мощность (т. е. Уотт) в указанное время |
Энергия сайта — период времени
Возвращает общую энергию сайта, произведенную в течение заданного периода.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сайта
|
site_id | True | integer |
Идентификатор сайта |
|
Дата начала для возврата измерения энергии
|
startDate | True | string |
Дата начала для возврата измерения энергии |
|
Значение даты окончания измерения энергии
|
endDate | True | string |
Значение даты окончания измерения энергии |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
Сводка по энергии |
|
единица
|
timeFrameEnergy.unit | string |
Единица энергии (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
Источник измерений |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Предоставленные сведения о дате начала |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Энергия даты начала |
|
единица
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Единица начальной даты (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Предоставленные сведения о дате окончания |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Энергия даты окончания |
|
единица
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Единица даты окончания (Wh) |