SolarEdge (Editora independente) (Visualização)

O conector SolarEdge oferece a oportunidade de exibir dados do sistema em outros aplicativos

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - 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/
Email	rwconnectors@gmail.com

Metadados do conector
Editora	Richard Wierenga
Sítio Web	https://www.solaredge.com/
Política de privacidade	https://monitoring.solaredge.com/solaredge-web/p/license
Categorias	Internet das Coisas; Dados

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 para esta api	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Benefícios ambientais do local	Devolve todos os benefícios ambientais com base na produção de energia no local: emissões de CO2 poupadas, árvores equivalentes plantadas e lâmpadas alimentadas por um dia.
Dados técnicos do inversor	Retornar dados específicos do inversor para um determinado período de tempo.
Detalhes do Site	Exibe os detalhes do site, como nome, localização, status, etc.
Energia do local	Devolver as medições de energia do local
Fluxo de energia do local	Recupera o fluxo de energia atual entre todos os elementos do local, incluindo matriz fotovoltaica, armazenamento (bateria), cargas (consumo) e grade.
Informações de armazenamento	Obtenha informações detalhadas de armazenamento das baterias: o estado da energia, potência e energia vitalícia.
Inventário do Site	Devolver o inventário de equipamentos SolarEdge no site, incluindo inversores/SMIs, baterias, medidores, gateways e sensores.
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. Esta API aceita parâmetros para pesquisa, classificação e paginação convenientes.
Obter dados de medidores	Devolve, para cada contador no local, a sua leitura de energia durante a vida útil, os metadados e o dispositivo ao qual está ligado.
Obter lista de sensores	Retorna uma lista de todos os sensores no site e o dispositivo ao qual eles estão conectados
Potência do local	Retornar as medições de energia do local em resolução de 15 minutos
Potência do Site - Detalhado	Medições detalhadas de potência do local a partir de medidores, como consumo, exportação (feed-in), importação (compra), etc.
Registo de Alterações de Equipamento	Devolve uma lista de substituições de componentes de equipamento ordenadas por data. Este método é aplicável a inversores, otimizadores, baterias e gateways.
Site Energia - Detalhado	Medições detalhadas de energia do local a partir de medidores como consumo, exportação (feed-in), importação (compra), etc.
Site Energy – Período de Tempo	Devolver ao local a energia total produzida durante um determinado período.
Visão geral do site	A resposta inclui a potência atual do local, energia diária, energia mensal, energia anual e energia do tempo de vida.

Benefícios ambientais do local

ID da Operação:

SiteEnvironmentalBenefits

Devolve todos os benefícios ambientais com base na produção de energia no local: emissões de CO2 poupadas, árvores equivalentes plantadas e lâmpadas alimentadas por um dia.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
unidades	envBenefits.gasEmissionSaved.units	string	unidades para o resto 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
árvoresPlantadas	envBenefits.treesPlanted	float	Plantação equivalente de novas árvores para reduzir os níveis de CO2
lâmpadasLâmpadas	envBenefits.lightBulbs	float	número de lâmpadas que poderiam ter sido alimentadas pelo local por um dia

Dados técnicos do inversor

ID da Operação:

InverterTechnicalData

Retornar dados específicos do inversor para um determinado período de tempo.

Parâmetros

Name	Chave	Necessá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 do inversor	startTime	True	string	O início (data + hora) para obter dados do inversor
O fim (data + hora) para obter dados do inversor	endTime	True	string	O fim (data + hora) para obter dados do inversor

Devoluções

Name	Caminho	Tipo	Description
count	data.count	integer	Contagem de respostas
telemetrias	data.telemetries	array of object	telemetrias
trifásicoInversorTelemetria	data.telemetries.threePhaseInverterTelemetry	array of object	trifásicoInversorTelemetria
date	data.telemetries.threePhaseInverterTelemetry.date	string	date
totalActivePower	data.telemetries.threePhaseInverterTelemetry.totalActivePower	string	totalActivePower
dcVoltagem	data.telemetries.threePhaseInverterTelemetry.dcVoltage	float	dcVoltagem
groundFaultResistance	data.telemetries.threePhaseInverterTelemetry.groundFaultResistance	float	groundFaultResistance
powerLimit [en]	data.telemetries.threePhaseInverterTelemetry.powerLimit	float	powerLimit [en]
totalEnergia	data.telemetries.threePhaseInverterTelemetry.totalEnergy	integer	totalEnergia
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	Inteiro do modo de operação 0 On-grid, 1 Operando no modo off-grid com PV ou bateria, 2 operando no modo off-grid com gerador
acCorrente	data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent	float	acCorrente
acVoltage	data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage	float	acVoltage
acFrequência	data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency	float	acFrequência
aparentePotência	data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower	integer	aparentePotência
Potência ativa	data.telemetries.threePhaseInverterTelemetry.L1Data.activePower	integer	Potência ativa
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
acCorrente	data.telemetries.threePhaseInverterTelemetry.L2Data.acCurrent	float	acCorrente
acVoltage	data.telemetries.threePhaseInverterTelemetry.L2Data.acVoltage	float	acVoltage
acFrequência	data.telemetries.threePhaseInverterTelemetry.L2Data.acFrequency	float	acFrequência
aparentePotência	data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower	integer	aparentePotência
Potência ativa	data.telemetries.threePhaseInverterTelemetry.L2Data.activePower	integer	Potência ativa
reactivePower	data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower	integer	reactivePower
cosPhi	data.telemetries.threePhaseInverterTelemetry.L2Data.cosPhi	integer	cosPhi
acCorrente	data.telemetries.threePhaseInverterTelemetry.L3Data.acCurrent	float	acCorrente
acVoltage	data.telemetries.threePhaseInverterTelemetry.L3Data.acVoltage	float	acVoltage
acFrequência	data.telemetries.threePhaseInverterTelemetry.L3Data.acFrequency	float	acFrequência
aparentePotência	data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower	integer	aparentePotência
Potência ativa	data.telemetries.threePhaseInverterTelemetry.L3Data.activePower	integer	Potência ativa
reactivePower	data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower	integer	reactivePower
cosPhi	data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi	integer	cosPhi

Detalhes do Site

ID da Operação:

SiteDetails

Exibe os detalhes do site, como nome, localização, status, etc.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
id	details.id	integer	O ID do site
nome	details.name	string	O nome do site
accountId	details.accountId	integer	A conta a que este site pertence
estado	details.status	string	O estado dos sites
pico de potência	details.peakPower	float	Os sites peakPower
moeda	details.currency	string	A moeda dos sites
instalaçãoData de instalação	details.installationDate	string	Instalação do site datetime, formato aaaa-mm-dd hh:mm:ss
ptoDate	details.ptoDate	string	Data de autorização de funcionamento
Observações	details.notes	string	Observações
tipo	details.type	string	Tipo de site
country	details.location.country	string	O país dos sites
city	details.location.city	string	Os sites da cidade
address	details.location.address	string	O endereço dos sites
Endereço2	details.location.address2	string	Endereço dos sítios2
ZIP	details.location.zip	string	Os sites zip
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 dos sites
alertQuantidade	details.alertQuantity	integer	Número de alertas abertos neste sítio
alertSeverity	details.alertSeverity	string	A maior severidade de alerta neste site
IMAGE_URI	details.uris.IMAGE_URI	string	A imagem dos sites uri

Energia do local

ID da Operação:

SiteEnergy

Devolver as medições de energia do local

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site
Granularidade da 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 medição de energia de retorno de data final	endDate	True	string	A medição de energia de retorno de data final

Devoluções

Name	Caminho	Tipo	Description
timeUnit	energy.timeUnit	string	Unidade de tempo solicitada
unidade	energy.unit	string	As unidades de medida
medidopor	energy.measuredBy	string	Fonte de medições
values	energy.values	array of object	Measurements
date	energy.values.date	string	Data e hora
valor	energy.values.value	float	Potência medida (ou seja, Watt) na data especificada

Fluxo de energia do local

ID da Operação:

SitePowerFlow

Recupera o fluxo de energia atual entre todos os elementos do local, incluindo matriz fotovoltaica, armazenamento (bateria), cargas (consumo) e grade.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	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 do fluxo de energia (elemento produtor e elemento consumidor)
de	siteCurrentPowerFlow.connections.from	string	O elemento que fornece energia
Para	siteCurrentPowerFlow.connections.to	string	O elemento que consome energia
estado	siteCurrentPowerFlow.GRID.status	string	Estado da grelha (Ativo/Inativo/Desativado)
currentPower [en]	siteCurrentPowerFlow.GRID.currentPower	float	rede elétrica atual
estado	siteCurrentPowerFlow.LOAD.status	string	Estado da carga (Ativo/Inativo/Desativado)
currentPower [en]	siteCurrentPowerFlow.LOAD.currentPower	float	Potência de carga atual
estado	siteCurrentPowerFlow.PV.status	string	Estado PV (Ativo / Inativo / Desativado)
currentPower [en]	siteCurrentPowerFlow.PV.currentPower	float	potência fotovoltaica atual
estado	siteCurrentPowerFlow.STORAGE.status	string	Estado do armazenamento (Ativo/Inativo/Desativado)
currentPower [en]	siteCurrentPowerFlow.STORAGE.currentPower	float	Alimentação de armazenamento atual
nível de carga	siteCurrentPowerFlow.STORAGE.chargeLevel	integer	Taxa de armazenamentoNível
crítico	siteCurrentPowerFlow.STORAGE.critical	boolean	Armazenamento crítico?
timeLeft	siteCurrentPowerFlow.STORAGE.timeLeft	integer	No modo de backup, tempo especificado antes que o armazenamento acabe

Informações de armazenamento

ID da Operação:

StorageInformation

Obtenha informações detalhadas de armazenamento das baterias: o estado da energia, potência e energia vitalícia.

Parâmetros

Name	Chave	Necessá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
Dados de retorno apenas para números de série específicos da bateria	serials		string	Retornar dados apenas para números de série específicos da bateria, a lista é separada por vírgula. Se omitida, a resposta inclui todas as baterias do site

Devoluções

Name	Caminho	Tipo	Description
bateriaContagem	storageData.batteryCount	integer	Número de baterias incluído na resposta
baterias	storageData.batteries	array of object	Uma lista de objetos de bateria
placa de identificação	storageData.batteries.nameplate	integer	A capacidade 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 da bateria
telemetriaContagem	storageData.batteries.telemetryCount	integer	O número de telemetrias para esta bateria na resposta
telemetrias	storageData.batteries.telemetries	array of object	Uma lista de telemetrias de dados de armazenamento
Carimbo de data/hora	storageData.batteries.telemetries.timeStamp	string	Carimbo de data/hora de telemetria no formato AAAA-MM-DD HH:MM:SS
power	storageData.batteries.telemetries.power	integer	Potência positiva indica que a bateria está carregando, negativa está descarregando
Estado da bateria	storageData.batteries.telemetries.batteryState	integer	Pode ser um dos seguintes 0 (Inválido), 1 (Em espera), 2 (Gerenciamento térmico), 3 (Habilitado), 4 (Falha)
lifeTimeEnergyCharged	storageData.batteries.telemetries.lifeTimeEnergyCharged	float	A energia carregada da bateria em Wh, durante a vida útil da bateria
lifeTimeEnergyDescarregado	storageData.batteries.telemetries.lifeTimeEnergyDischarged	float	A energia descarregada da bateria em Wh, durante a vida útil da bateria
fullPackEnergiaDisponível	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 CA usada para carregar a bateria da rede dentro de um intervalo de datas especificado em Wh
stateOfCharge	storageData.batteries.telemetries.stateOfCharge	integer	o estado de carga da bateria em percentagem da capacidade disponível. Os valores estão na faixa de 0 a 100

Inventário do Site

ID da Operação:

SiteInventory

Devolver o inventário de equipamentos SolarEdge no site, incluindo inversores/SMIs, baterias, medidores, gateways e sensores.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
medidores	Inventory.meters	array of object	Lista de medidores para o local especificado
nome	Inventory.meters.name	string	Nome do contador
fabricante	Inventory.meters.manufacturer	string	Fabricante do medidor
modelo	Inventory.meters.model	string	Modelo do contador
firmwareVersão	Inventory.meters.firmwareVersion	string	Firmware do medidorVersão
conectadoSolaredgeDeviceSN	Inventory.meters.connectedSolaredgeDeviceSN	string	– Nome do dispositivo SolarEdge ao qual o medidor está conectado
tipo	Inventory.meters.type	string	Tipo de contador, por exemplo, "Produção"
formulário	Inventory.meters.form	string	física para um contador de HW ou virtual se calculada por aritmética entre outros contadores
Sensores	Inventory.sensors	array of object	Lista de sensores para o local especificado
conectadoSolaredgeDeviceSN	Inventory.sensors.connectedSolaredgeDeviceSN	string	– Nome do dispositivo SolarEdge ao qual o sensor está conectado
id	Inventory.sensors.id	string	ID do sensor
conectadoTo	Inventory.sensors.connectedTo	string	nome do dispositivo ao qual está ligado, por exemplo, "Gateway 1"
categoria	Inventory.sensors.category	string	Categoria do sensor, por exemplo, IRRADIÂNCIA
tipo	Inventory.sensors.type	string	Tipo de sensor, por exemplo, "Plano de irradiância da matriz"
gateways	Inventory.gateways	array of object	Lista de gateways para o site especificado
nome	Inventory.gateways.name	string	O nome do inversor, por exemplo, Inversor 1
firmwareVersão	Inventory.gateways.firmwareVersion	string	A versão de firmware 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 local 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 da bateria
firmwareVersão	Inventory.batteries.firmwareVersion	string	O firmware da bateriaVersão
connectedInverterSn	Inventory.batteries.connectedInverterSn	string	– número de série do inversor / gateway ao qual a bateria está conectada
nameplateCapacidade	Inventory.batteries.nameplateCapacity	integer	a capacidade da placa de identificação da bateria, fornecida 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 local 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 do inversor
firmwareVersão	Inventory.inverters.firmwareVersion	string	O firmware do inversorVersion
SN	Inventory.inverters.SN	string	O número de série do inversor
connectedOptimizers	Inventory.inverters.connectedOptimizers	integer	Número de otimizadores conectados ao inversor

Lista de componentes

ID da Operação:

ComponentsList

Retornar uma lista de inversores/SMIs no site específico

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
count	reporters.count	integer	A contagem de componentes de sites
lista	reporters.list	array of object	lista
Nome do componente	reporters.list.componentname	string	O nome do componente
fabricante	reporters.list.manufacturer	string	O fabricante do componente
Modelo	reporters.list.Model	string	O modelo do componente
SerialNumber	reporters.list.SerialNumber	string	O componente serialNumber

Lista de Sites

ID da Operação:

SitesList

Retorna uma lista de sites relacionados ao token fornecido, que é a conta api_key. Esta API aceita parâmetros para pesquisa, classificação e paginação convenientes.

Devoluções

Name	Caminho	Tipo	Description
count	sites.count	integer	A quantidade de sites que são retornados.
site	sites.site	array of object	site
ID do Site	sites.site.id	integer	O ID do site.
nome	sites.site.name	string	O nome do site
accountId	sites.site.accountId	integer	A conta a que este site pertence
estado	sites.site.status	string	O estado do site
pico de potência	sites.site.peakPower	float	Potência de pico do local
horaDaÚltimaAtualização	sites.site.lastUpdateTime	string	Data da última atualização do site, formato aaaa-mm-dd hh:mm:ss
instalaçãoData de instalação	sites.site.installationDate	string	Instalação do site datetime, formato aaaa-mm-dd hh:mm:ss
ptoDate	sites.site.ptoDate	string	Data de autorização de funcionamento
Observações	sites.site.notes	string	Observaçõ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	Os sites da cidade
address	sites.site.location.address	string	O endereço dos sites
Endereço2	sites.site.location.address2	string	Endereço dos sítios2
ZIP	sites.site.location.zip	string	Os sites zip
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 dos sites
Nome do fabricante	sites.site.primaryModule.manufacturerName	string	FabricanteNome do fabricante do modelo primário
modelName	sites.site.primaryModule.modelName	string	Modelo primárioNome do modelo
potência máxima	sites.site.primaryModule.maximumPower	float	Potência máxima do modelo primário
temperaturaCoef	sites.site.primaryModule.temperatureCoef	float	Temperatura do modelo primárioCoef

Obter dados de medidores

ID da Operação:

GetMetersData

Devolve, para cada contador no local, a sua leitura de energia durante a vida útil, os metadados e o dispositivo ao qual está ligado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site
Granularidade da agregação	timeUnit		string	Granularidade de agregação, os valores permitidos são QUARTER_OF_AN_HOUR, HORA, DIA, SEMANA, MÊS, ANO
A energia medida a hora de início no formato aaaa-MM-DD hh:mm:ss	startTime	True	string	A energia medida a hora de início no formato aaaa-MM-DD hh:mm:ss
A energia medida no formato aaaa-MM-DD hh:mm:ss	endTime	True	string	A energia medida no formato aaaa-MM-DD hh:mm:ss
Selecionar apenas medidores específicos	meters		string	Selecione apenas medidores específicos. Se esse valor for omitido, todas as leituras do medidor serão retornadas. Os valores permitidos são Produção, Consumo, FeedIn, Comprado

Devoluções

Name	Caminho	Tipo	Description
timeUnit	meterEnergyDetails.timeUnit	string	Granularidade da agregação
unidade	meterEnergyDetails.unit	string	Unidade de medidores devolvidos (Wh)
medidores	meterEnergyDetails.meters	array of object	Valores por metro
meterSerialNumber	meterEnergyDetails.meters.meterSerialNumber	string	meterSerialNumber
conectadoSolaredgeDeviceSN	meterEnergyDetails.meters.connectedSolaredgeDeviceSN	string	Inversor ao qual o contador está ligado
modelo	meterEnergyDetails.meters.model	string	Modelo do contador
meterType	meterEnergyDetails.meters.meterType	string	Tipo de medidor Produção, Consumo, FeedIn ou Comprado
values	meterEnergyDetails.meters.values	array of object	Valores por metro por data
date	meterEnergyDetails.meters.values.date	string	Carimbo de data/hora de medição
valor	meterEnergyDetails.meters.values.value	float	Leitura de energia ao longo da vida

Obter lista de sensores

ID da Operação:

GetSensorList

Retorna uma lista de todos os sensores no site e o dispositivo ao qual eles estão conectados

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
count	SiteSensors.count	integer	A contagem de sensores de sites
lista	SiteSensors.list	array of object	Lista por gateway
conectadoTo	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
Medição	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

Potência do local

ID da Operação:

SitePower

Retornar as medições de energia do local em resolução de 15 minutos

Parâmetros

Name	Chave	Necessário	Tipo	Description
A data e hora de início	startTime	True	string	A data e hora de início (aaaa-mm-dd hh:mm:ss) para obter medições de potência
A data e hora de início	endTime	True	string	A data e hora de início (aaaa-mm-dd hh:mm:ss) para obter medições de potência
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	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)
medidopor	power.measuredBy	string	Fonte de medições
values	power.values	array of object	Measurements
date	power.values.date	string	Data e hora
valor	power.values.value	float	Potência medida (ou seja, Watt) na data especificada

Potência do Site - Detalhado

ID da Operação:

SitePowerDetailed

Medições detalhadas de potência do local a partir de medidores, como consumo, exportação (feed-in), importação (compra), etc.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site
A energia medida a hora de início	startTime	True	string	A energia medida a hora de início no formato aaaa-MM-DD hh:mm:ss
A energia medida no tempo de fim	endTime	True	string	A energia medida no formato aaaa-MM-DD hh:mm:ss

Devoluções

Name	Caminho	Tipo	Description
timeUnit	powerDetails.timeUnit	string	Unidade de tempo solicitada
unidade	powerDetails.unit	string	As unidades de medida
medidores	powerDetails.meters	array of object	Medidores
tipo	powerDetails.meters.type	string	O tipo de contador (Produção/Consumo/Autoconsumo/FeedIn (exportação)/Comprado (importação))
values	powerDetails.meters.values	array of object	Pares de data e potência para cada data
date	powerDetails.meters.values.date	string	Data e hora
valor	powerDetails.meters.values.value	float	Alimentação para data/hora especificada

Registo de Alterações de Equipamento

ID da Operação:

EquipmentChangeLog

Devolve uma lista de substituições de componentes de equipamento ordenadas por data. Este método é aplicável a inversores, otimizadores, baterias e gateways.

Parâmetros

Name	Chave	Necessá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

Devoluções

Name	Caminho	Tipo	Description
count	ChangeLog.count	integer	count
serialNumber	ChangeLog.list.serialNumber	string	Número de série curto do equipamento
número de peça	ChangeLog.list.partNumber	string	modelo de inversor/bateria/otimizador/gateway
date	ChangeLog.list.date	string	Data de substituição desse componente do equipamento

Site Energia - Detalhado

ID da Operação:

SiteEnergyDetailed

Medições detalhadas de energia do local a partir de medidores como consumo, exportação (feed-in), importação (compra), etc.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site
Granularidade da 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 energia medida a hora de início no formato aaaa-MM-DD hh:mm:ss	startTime	True	string	A energia medida a hora de início no formato aaaa-MM-DD hh:mm:ss
A energia medida no formato aaaa-MM-DD hh:mm:ss	endTime	True	string	A energia medida no formato aaaa-MM-DD hh:mm:ss
Selecionar apenas medidores específicos	Meters	True	string	Selecione apenas medidores específicos, se tudo estiver em branco retornado. Os valores permitidos são PRODUÇÃO, CONSUMO, Autoconsumo, FeedIn, Comprado

Devoluções

Name	Caminho	Tipo	Description
timeUnit	energyDetails.timeUnit	string	Unidade de tempo solicitada
unidade	energyDetails.unit	string	As unidades de medida
medidores	energyDetails.meters	array of object	medidores
tipo	energyDetails.meters.type	string	tipo
values	energyDetails.meters.values	array of object	values
date	energyDetails.meters.values.date	string	Data e hora
valor	energyDetails.meters.values.value	float	Potência medida (ou seja, Watt) na data especificada

Site Energy – Período de Tempo

ID da Operação:

SiteEnergyTimePeriod

Devolver ao local a energia total produzida durante um determinado período.

Parâmetros

Name	Chave	Necessá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 medição de energia de retorno de data final	endDate	True	string	A medição de energia de retorno de data final

Devoluções

Name	Caminho	Tipo	Description
energia	timeFrameEnergy.energy	float	Resumo da energia
unidade	timeFrameEnergy.unit	string	Unidade de energia (Wh)
medidopor	timeFrameEnergy.measuredBy	string	A fonte das medições
date	timeFrameEnergy.startLifetimeEnergy.date	string	Informações de data de início fornecidas
energia	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 sobre a data de fim fornecidas
energia	timeFrameEnergy.endLifetimeEnergy.energy	float	Energia de data de fim
unidade	timeFrameEnergy.endLifetimeEnergy.unit	string	Unidade de data de fim (Wh)

Visão geral do site

ID da Operação:

SiteOverview

A resposta inclui a potência atual do local, energia diária, energia mensal, energia anual e energia do tempo de vida.

Parâmetros

Name	Chave	Necessário	Tipo	Description
O identificador do site	site_id	True	integer	O identificador do site

Devoluções

Name	Caminho	Tipo	Description
horaDaÚltimaAtualização	overview.lastUpdateTime	string	horaDaÚltimaAtualização
energia	overview.lifeTimeData.energy	float	Número de energia durante o tempo de vida
energia	overview.lastYearData.energy	float	Número de energia do ano passado
energia	overview.lastMonthData.energy	float	Número de energia
energia	overview.lastDayData.energy	float	Número de energia do último dia
power	overview.currentPower.power	float	Número de potência atual
medidopor	overview.measuredBy	string	Medido por