SolarEdge (Editor Independente) (versão prévia)
O conector SolarEdge oferece a opurtunidade para exibir dados do sistema em outros aplicativos
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Richard Wierenga |
| URL | https://knowledge-center.solaredge.com/ |
| rwconnectors@gmail.com |
| Metadados do conector | |
|---|---|
| Publicador | Richard Wierenga |
| Site | https://www.solaredge.com/ |
| Política de privacidade | https://monitoring.solaredge.com/solaredge-web/p/license |
| Categorias | Internet das Coisas; Dados |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| chave_de_api | secureString | O api_key desta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Benefícios ambientais do site |
Retorna todos os benefícios ambientais com base na produção de energia do local: emissões de CO2 salvas, árvores equivalentes plantadas e lâmpadas alimentadas por um dia. |
| Detalhes do site |
Exibe os detalhes do site, como nome, local, status etc. |
| Energia do site |
Retornar as medidas de energia do site |
| Energia do Site – Detalhado |
Medições detalhadas de energia do site de medidores como consumo, exportação (feed-in), importação (compra), etc. |
| Energia do Site – Período de Tempo |
Retorne a energia total do local produzida por um determinado período. |
| Fluxo de Energia do Site |
Recupera o fluxo de energia atual entre todos os elementos do site, incluindo matriz PV, armazenamento (bateria), cargas (consumo) e grade. |
| Informações de armazenamento |
Obtenha informações detalhadas de armazenamento das baterias: o estado da energia, energia e energia de tempo de vida. |
| Inventário de Site |
Retorne o inventário de equipamentos SolarEdge no local, incluindo inversores/SMIs, baterias, medidores, gateways e sensores. |
| Inverter Dados Técnicos |
Retornar dados inversos específicos para um determinado período de tempo. |
| Lista de componentes |
Retornar uma lista de inversores/SMIs no site específico |
| Lista de Sites |
Retorna uma lista de sites relacionados ao token fornecido, que é a conta api_key. Essa API aceita parâmetros para pesquisa, classificação e paginação convenientes. |
| Log de Alterações de Equipamento |
Retorna uma lista de substituições de componente de equipamento ordenadas por data. Esse método é aplicável a inversores, otimizadores, baterias e gateways. |
| Obter dados de medidores |
Retorna para cada medidor no local sua leitura de energia de tempo de vida, metadados e o dispositivo ao qual ele está conectado. |
| Obter lista de sensores |
Retorna uma lista de todos os sensores no site e o dispositivo ao qual eles estão conectados |
| Poder do site |
Retornar as medidas de energia do site em 15 minutos de resolução |
| Poder do Site – Detalhado |
Medições detalhadas de energia do site de medidores, como consumo, exportação (feed-in), importação (compra), etc. |
| Visão geral do site |
A resposta inclui a energia atual do local, energia diária, energia mensal, energia anual e energia em tempo de vida. |
Benefícios ambientais do site
Retorna todos os benefícios ambientais com base na produção de energia do local: emissões de CO2 salvas, árvores equivalentes plantadas e lâmpadas alimentadas por um dia.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Unidades
|
envBenefits.gasEmissionSaved.units | string |
unidades para o restante dos resultados |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 em Kg ou Lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 em Kg ou Lb |
|
Nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX em Kg ou Lb |
|
treesPlanted
|
envBenefits.treesPlanted | float |
Plantio equivalente de novas árvores para reduzir os níveis de CO2 |
|
Lâmpadas
|
envBenefits.lightBulbs | float |
número de lâmpadas que poderiam ter sido alimentadas pelo site por um dia |
Detalhes do site
Exibe os detalhes do site, como nome, local, status etc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
details.id | integer |
A ID do site |
|
nome
|
details.name | string |
O nome do site |
|
ID da conta
|
details.accountId | integer |
A conta à qual este site pertence |
|
status
|
details.status | string |
O status dos sites |
|
peakPower
|
details.peakPower | float |
Os sites peakPower |
|
moeda
|
details.currency | string |
A moeda dos sites |
|
installationDate
|
details.installationDate | string |
Datetime de instalação do site, formato yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
Permissão para operar data |
|
notas
|
details.notes | string |
Anotações |
|
tipo
|
details.type | string |
Tipo de site |
|
country
|
details.location.country | string |
O país dos sites |
|
city
|
details.location.city | string |
A cidade dos sites |
|
address
|
details.location.address | string |
O endereço dos sites |
|
endereço2
|
details.location.address2 | string |
O endereço dos sites2 |
|
zip
|
details.location.zip | string |
O zip de sites |
|
Fuso horário
|
details.location.timeZone | string |
O fuso horário dos sites |
|
código do país
|
details.location.countryCode | string |
Código do país de sites |
|
alertQuantity
|
details.alertQuantity | integer |
Número de alertas abertos neste site |
|
alertSeverity
|
details.alertSeverity | string |
A severidade de alerta mais alta neste site |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
O uri da imagem de sites |
Energia do site
Retornar as medidas de energia do site
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
Granularidade de agregação
|
timeUnit | True | string |
Granularidade de agregação, os valores permitidos são QUARTER_OF_AN_HOUR, HORA, DIA, SEMANA, MÊS, ANO |
|
A data de início para retornar a medição de energia
|
startDate | True | string |
A data de início para retornar a medição de energia |
|
A medida de energia de retorno da data de término
|
endDate | True | string |
A medida de energia de retorno da data de término |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Unidade de tempo solicitada |
|
unidade
|
energy.unit | string |
As unidades de medida |
|
measuredBy
|
energy.measuredBy | string |
Origem das medidas |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Data e hora |
|
value
|
energy.values.value | float |
Potência medida(ou seja, Watt) em datetime especificado |
Energia do Site – Detalhado
Medições detalhadas de energia do site de medidores como consumo, exportação (feed-in), importação (compra), etc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
Granularidade de agregação
|
timeUnit | True | string |
Granularidade de agregação, os valores permitidos são QUARTER_OF_AN_HOUR, HORA, DIA, SEMANA, MÊS, ANO |
|
A hora de início medida pela energia no formato yyyy-MM-DD hh:mm:ss
|
startTime | True | string |
A hora de início medida pela energia no formato yyyy-MM-DD hh:mm:ss |
|
A hora de término medida pela energia no formato yyyy-MM-DD hh:mm:ss
|
endTime | True | string |
A hora de término medida pela energia no formato yyyy-MM-DD hh:mm:ss |
|
Selecionar somente medidores específicos
|
Meters | True | string |
Selecione somente medidores específicos, se tudo estiver em branco retornado. Os valores permitidos são PRODUCTION, CONSUMPTION, SelfConsumption, FeedIn, Purchased |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Unidade de tempo solicitada |
|
unidade
|
energyDetails.unit | string |
As unidades de medida |
|
Metros
|
energyDetails.meters | array of object |
Metros |
|
tipo
|
energyDetails.meters.type | string |
tipo |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Data e hora |
|
value
|
energyDetails.meters.values.value | float |
Potência medida(ou seja, Watt) em datetime especificado |
Energia do Site – Período de Tempo
Retorne a energia total do local produzida por um determinado período.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
A data de início para retornar a medição de energia
|
startDate | True | string |
A data de início para retornar a medição de energia |
|
A medida de energia de retorno da data de término
|
endDate | True | string |
A medida de energia de retorno da data de término |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
Resumo de energia |
|
unidade
|
timeFrameEnergy.unit | string |
Unidade de energia (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
A origem das medidas |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Informações de data de início fornecidas |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Energia da data de início |
|
unidade
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Unidade de data de início (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Informações de data de término fornecidas |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Energia da data de término |
|
unidade
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Unidade de data de término (Wh) |
Fluxo de Energia do Site
Recupera o fluxo de energia atual entre todos os elementos do site, incluindo matriz PV, armazenamento (bateria), cargas (consumo) e grade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
unidade
|
siteCurrentPowerFlow.unit | string |
As unidades de medida (por exemplo, Watt) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
Uma tabela que inclui todas as relações entre os elementos e as direções de fluxo de energia (produzindo elemento e consumindo elemento) |
|
from
|
siteCurrentPowerFlow.connections.from | string |
O elemento que fornece energia |
|
para
|
siteCurrentPowerFlow.connections.to | string |
O elemento que consome energia |
|
status
|
siteCurrentPowerFlow.GRID.status | string |
Status da grade (Ativo/Ocioso/Desabilitado) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
Energia da grade atual |
|
status
|
siteCurrentPowerFlow.LOAD.status | string |
Status da carga (Ativo/Ocioso/Desabilitado) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
Energia de carga atual |
|
status
|
siteCurrentPowerFlow.PV.status | string |
Status de PV (ativo/ocioso/desabilitado) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
Energia PV atual |
|
status
|
siteCurrentPowerFlow.STORAGE.status | string |
Status do armazenamento (Ativo/Ocioso/Desabilitado) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
Poder de armazenamento atual |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
Carga de armazenamentoLevel |
|
crítico
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
Armazenamento crítico? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
No modo de backup, o tempo especificado antes do armazenamento ser executado |
Informações de armazenamento
Obtenha informações detalhadas de armazenamento das baterias: o estado da energia, energia e energia de tempo de vida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
O identificador do site
|
startTime | True | string |
O identificador do site |
|
O identificador do site
|
endTime | True | string |
O identificador do site |
|
Retornar dados somente para números de série de bateria específicos
|
serials | string |
Retornar dados somente para números de série de bateria específicos, a lista é separada por vírgula. Se omitida, a resposta inclui todas as baterias no site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
Número de baterias incluídas na resposta |
|
Baterias
|
storageData.batteries | array of object |
Uma lista de objetos de bateria |
|
Placa
|
storageData.batteries.nameplate | integer |
A capacidade da placa de nome (nominal) da bateria |
|
serialNumber
|
storageData.batteries.serialNumber | string |
O número de série da bateria |
|
número do modelo
|
storageData.batteries.modelNumber | string |
Número do modelo de bateria |
|
telemetryCount
|
storageData.batteries.telemetryCount | integer |
O número de telemetrias dessa bateria na resposta |
|
telemetrias
|
storageData.batteries.telemetries | array of object |
Uma lista de telemetrias de dados de armazenamento |
|
timestamp
|
storageData.batteries.telemetries.timeStamp | string |
Carimbo de data/hora de telemetria no formato YYYY-MM-DD HH:MM:SS |
|
energia
|
storageData.batteries.telemetries.power | integer |
A energia positiva indica que a bateria está carregando, o negativo é a descarregação |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Pode ser um dos seguintes 0 (Inválido), 1 (Espera), 2 (Mgmt Térmico).), 3 (Habilitado), 4 (Falha) |
|
lifeTimeEnergyCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
A energia carregada da bateria em Wh, durante o tempo de vida da bateria |
|
lifeTimeEnergyDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
A energia descarregada da bateria em Wh, durante o tempo de vida da bateria |
|
fullPackEnergyAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
A energia máxima (Wh) que atualmente pode ser armazenada na bateria |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Temperatura interna da bateria em Celsius |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Quantidade de energia AC usada para carregar a bateria da grade dentro de um intervalo de datas especificado em Wh |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
o estado de carga da bateria como percentual da capacidade disponível. Os valores estão no intervalo de 0 a 100 |
Inventário de Site
Retorne o inventário de equipamentos SolarEdge no local, incluindo inversores/SMIs, baterias, medidores, gateways e sensores.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Metros
|
Inventory.meters | array of object |
Lista de medidores para o site especificado |
|
nome
|
Inventory.meters.name | string |
Nome do medidor |
|
fabricante
|
Inventory.meters.manufacturer | string |
Fabricante do medidor |
|
modelo
|
Inventory.meters.model | string |
Modelo de medidor |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
FirmwareVersion de medidor |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– Nome do dispositivo SolarEdge ao qual o medidor está conectado |
|
tipo
|
Inventory.meters.type | string |
Tipo de medidor, por exemplo, "Produção" |
|
formulário
|
Inventory.meters.form | string |
físico para um medidor HW ou virtual se calculado por aritmética entre outros medidores |
|
Sensores
|
Inventory.sensors | array of object |
Lista de sensores para o site especificado |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– Nome do dispositivo SolarEdge ao qual o sensor está conectado |
|
id
|
Inventory.sensors.id | string |
ID do sensor |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
nome do dispositivo ao qual ele está conectado, por exemplo, "Gateway 1" |
|
categoria
|
Inventory.sensors.category | string |
Categoria do sensor, por exemplo, RADIANCE |
|
tipo
|
Inventory.sensors.type | string |
Tipo de sensor, por exemplo, "Plano de radiação de matriz" |
|
gateways
|
Inventory.gateways | array of object |
Lista de gateways para o site especificado |
|
nome
|
Inventory.gateways.name | string |
O nome inversor, por exemplo, Inverter 1 |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
O firmwareversion do equipamento |
|
SN
|
Inventory.gateways.SN | string |
O número de série do equipamento, por exemplo, 7F123456-00 |
|
Baterias
|
Inventory.batteries | array of object |
Lista de baterias para o site especificado |
|
nome
|
Inventory.batteries.name | string |
O nome da bateria |
|
fabricante
|
Inventory.batteries.manufacturer | string |
O fabricante da bateria |
|
modelo
|
Inventory.batteries.model | string |
O modelo de bateria |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
O firmwareVersion de bateria |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– número de série do inversor/gateway ao qual a bateria está conectada |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
a capacidade da placa de nome da bateria, conforme fornecido pelo fabricante |
|
SN
|
Inventory.batteries.SN | string |
Número de série da bateria |
|
Inversores
|
Inventory.inverters | array of object |
Lista de inversores para o site especificado |
|
nome
|
Inventory.inverters.name | string |
O nome do inversor |
|
fabricante
|
Inventory.inverters.manufacturer | string |
O fabricante do inversor |
|
modelo
|
Inventory.inverters.model | string |
O modelo inversor |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
O firmwareVersion inverter |
|
SN
|
Inventory.inverters.SN | string |
O serialnumber inverter |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Número de otimizadores conectados ao inversor |
Inverter Dados Técnicos
Retornar dados inversos específicos para um determinado período de tempo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
O número de série do equipamento
|
equipment_id | True | string |
O número de série do equipamento |
|
O início (data + hora) para obter dados inversos
|
startTime | True | string |
O início (data + hora) para obter dados inversos |
|
O final (data + hora) para obter dados inversos
|
endTime | True | string |
O final (data + hora) para obter dados inversos |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
data.count | integer |
Contagem de respostas |
|
telemetrias
|
data.telemetries | array of object |
telemetrias |
|
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 |
|
totalEnergy
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
totalEnergy |
|
temperatura
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Temperatura em Celsius |
|
inverterMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
Estado do inversor, ou seja, OFF, STARTING, MPPT etc. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Número inteiro do modo de operação 0 Na grade, 1 Operando no modo fora da grade com PV ou Bateria, 2 operando no modo fora da grade com gerador |
|
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 |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reactivePower |
|
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 |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reactivePower |
|
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 |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Lista de componentes
Retornar uma lista de inversores/SMIs no site específico
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
reporters.count | integer |
A contagem de componentes de sites |
|
lista
|
reporters.list | array of object |
lista |
|
componentname
|
reporters.list.componentname | string |
O nome do componente |
|
fabricante
|
reporters.list.manufacturer | string |
O fabricante do componente |
|
Modelo
|
reporters.list.Model | string |
O modelo de componente |
|
Número de Série
|
reporters.list.SerialNumber | string |
O serialNumber do componente |
Lista de Sites
Retorna uma lista de sites relacionados ao token fornecido, que é a conta api_key. Essa API aceita parâmetros para pesquisa, classificação e paginação convenientes.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
sites.count | integer |
A quantidade de sites retornados. |
|
site
|
sites.site | array of object |
site |
|
SiteID
|
sites.site.id | integer |
A ID do site. |
|
nome
|
sites.site.name | string |
O nome do site |
|
ID da conta
|
sites.site.accountId | integer |
A conta à qual este site pertence |
|
status
|
sites.site.status | string |
O status do site |
|
peakPower
|
sites.site.peakPower | float |
Energia de pico do site |
|
horaDaÚltimaAtualização
|
sites.site.lastUpdateTime | string |
Data/hora da última atualização do site, formato yyyy-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
Datetime de instalação do site, formato yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
Permissão para operar data |
|
notas
|
sites.site.notes | string |
Anotações |
|
tipo
|
sites.site.type | string |
Tipo de site |
|
country
|
sites.site.location.country | string |
O país dos sites |
|
city
|
sites.site.location.city | string |
A cidade dos sites |
|
address
|
sites.site.location.address | string |
O endereço dos sites |
|
endereço2
|
sites.site.location.address2 | string |
O endereço dos sites2 |
|
zip
|
sites.site.location.zip | string |
O zip de sites |
|
Fuso horário
|
sites.site.location.timeZone | string |
O fuso horário dos sites |
|
código do país
|
sites.site.location.countryCode | string |
Código do país de sites |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
Nomename do modelo primário |
|
modelName
|
sites.site.primaryModule.modelName | string |
ModelName do modelo primário |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
MaximumPower do modelo primário |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
TemperatureCoef do modelo primário |
Log de Alterações de Equipamento
Retorna uma lista de substituições de componente de equipamento ordenadas por data. Esse método é aplicável a inversores, otimizadores, baterias e gateways.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
O número de série do equipamento
|
equipment_id | True | string |
O número de série do equipamento |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Número de série curto do equipamento |
|
partNumber
|
ChangeLog.list.partNumber | string |
inverter/battery/optimizer/gateway model |
|
date
|
ChangeLog.list.date | string |
Data da substituição desse componente de equipamento |
Obter dados de medidores
Retorna para cada medidor no local sua leitura de energia de tempo de vida, metadados e o dispositivo ao qual ele está conectado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
Granularidade de agregação
|
timeUnit | string |
Granularidade de agregação, os valores permitidos são QUARTER_OF_AN_HOUR, HORA, DIA, SEMANA, MÊS, ANO |
|
|
A hora de início medida pela energia no formato yyyy-MM-DD hh:mm:ss
|
startTime | True | string |
A hora de início medida pela energia no formato yyyy-MM-DD hh:mm:ss |
|
A hora de término medida pela energia no formato yyyy-MM-DD hh:mm:ss
|
endTime | True | string |
A hora de término medida pela energia no formato yyyy-MM-DD hh:mm:ss |
|
Selecionar somente medidores específicos
|
meters | string |
Selecione somente medidores específicos. Se esse valor for omitido, todas as leituras de medidor serão retornadas. Os valores permitidos são Produção, Consumo, FeedIn, Comprado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Granularidade de agregação |
|
unidade
|
meterEnergyDetails.unit | string |
Unidade de medidores retornados (Wh) |
|
Metros
|
meterEnergyDetails.meters | array of object |
Valores por medidor |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Inverter ao qual o medidor está conectado |
|
modelo
|
meterEnergyDetails.meters.model | string |
Modelo de medidor |
|
meterType
|
meterEnergyDetails.meters.meterType | string |
Tipo de medidor Produção, Consumo, FeedIn ou Comprado |
|
values
|
meterEnergyDetails.meters.values | array of object |
Valores por medidor por data |
|
date
|
meterEnergyDetails.meters.values.date | string |
Carimbo de data/hora de medição |
|
value
|
meterEnergyDetails.meters.values.value | float |
Leitura de energia de tempo de vida |
Obter lista de sensores
Retorna uma lista de todos os sensores no site e o dispositivo ao qual eles estão conectados
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
A contagem de sensores de sites |
|
lista
|
SiteSensors.list | array of object |
Listar por gateway |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Nome do gateway ao qual o sensor está conectado |
|
count
|
SiteSensors.list.count | integer |
A contagem de sensores de gateways |
|
Sensores
|
SiteSensors.list.sensors | array of object |
Sensores |
|
nome
|
SiteSensors.list.sensors.name | string |
Nome do sensor |
|
medida
|
SiteSensors.list.sensors.measurement | string |
O que o sensor mede, por exemplo, SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
tipo
|
SiteSensors.list.sensors.type | string |
o que o sensor mede, por exemplo, SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Poder do site
Retornar as medidas de energia do site em 15 minutos de resolução
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A data e a hora de início
|
startTime | True | string |
A data e a hora de início (yyyy-mm-dd hh:mm:ss) para obter medidas de energia |
|
A data e a hora de início
|
endTime | True | string |
A data e a hora de início (yyyy-mm-dd hh:mm:ss) para obter medidas de energia |
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Unidade de tempo (ou seja, QUARTER_OF_AN_HOUR) |
|
unidade
|
power.unit | string |
Unidade de medida (ou seja, Watt) |
|
measuredBy
|
power.measuredBy | string |
Origem das medidas |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Data e hora |
|
value
|
power.values.value | float |
Potência medida(ou seja, Watt) em datetime especificado |
Poder do Site – Detalhado
Medições detalhadas de energia do site de medidores, como consumo, exportação (feed-in), importação (compra), etc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
|
A hora de início medida pela energia
|
startTime | True | string |
A hora de início medida pela energia no formato yyyy-MM-DD hh:mm:ss |
|
A hora de término medida pela energia
|
endTime | True | string |
A hora de término medida pela energia no formato yyyy-MM-DD hh:mm:ss |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Unidade de tempo solicitada |
|
unidade
|
powerDetails.unit | string |
As unidades de medidas |
|
Metros
|
powerDetails.meters | array of object |
Medidores |
|
tipo
|
powerDetails.meters.type | string |
O tipo de medidor (Produção/Consumo/SelfConsumption/FeedIn (exportação)/Purchased(import)) |
|
values
|
powerDetails.meters.values | array of object |
Pares de data e energia para cada data |
|
date
|
powerDetails.meters.values.date | string |
Data e hora |
|
value
|
powerDetails.meters.values.value | float |
Energia para datetime especificado |
Visão geral do site
A resposta inclui a energia atual do local, energia diária, energia mensal, energia anual e energia em tempo de vida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O identificador do site
|
site_id | True | integer |
O identificador do site |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
horaDaÚltimaAtualização
|
overview.lastUpdateTime | string |
horaDaÚltimaAtualização |
|
energy
|
overview.lifeTimeData.energy | float |
Número de energia de tempo de vida |
|
energy
|
overview.lastYearData.energy | float |
Número de energia do ano passado |
|
energy
|
overview.lastMonthData.energy | float |
Número de energia |
|
energy
|
overview.lastDayData.energy | float |
Número de energia do último dia |
|
energia
|
overview.currentPower.power | float |
Número de energia atual |
|
measuredBy
|
overview.measuredBy | string |
Medido por |