SolarEdge (Éditeur indépendant) (préversion)
Le connecteur SolarEdge vous donne l’oppurtunity pour afficher les données système dans d’autres applications
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Richard Wierenga |
| URL | https://knowledge-center.solaredge.com/ |
| Messagerie électronique | rwconnectors@gmail.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Richard Wierenga |
| Site internet | https://www.solaredge.com/ |
| Politique de confidentialité | https://monitoring.solaredge.com/solaredge-web/p/license |
| Catégories | Internet des objets ; Données |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé API | securestring | La api_key de cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Alimentation du site |
Renvoyer les mesures d’alimentation du site en résolution de 15 minutes |
| Avantages environnementaux du site |
Retourne tous les avantages environnementaux en fonction de la production d’énergie du site : émissions de CO2 économisés, arbres équivalents plantés et ampoules alimentées pendant une journée. |
| Données techniques d’onduleur |
Retournez des données d’onduleur spécifiques pour une période donnée. |
| Détails du site |
Affiche les détails du site, tels que le nom, l’emplacement, l’état, etc. |
| Flux d’alimentation du site |
Récupère le flux d’alimentation actuel entre tous les éléments du site, y compris le réseau PV, le stockage (batterie), les charges (consommation) et la grille. |
| Informations de stockage |
Obtenez des informations détaillées sur le stockage des piles : l’état de l’énergie, de l’énergie et de la durée de vie. |
| Inventaire des sites |
Retournez l’inventaire des équipements SolarEdge sur le site, y compris les onduleurs/SMIs, les batteries, les compteurs, les passerelles et les capteurs. |
| Journal des modifications d’équipement |
Retourne la liste des remplacements de composants d’équipement classés par date. Cette méthode s’applique aux onduleurs, optimiseurs, piles et passerelles. |
| Liste des composants |
Retourner une liste d’onduleurs/PME dans le site spécifique |
| Liste des sites |
Retourne une liste de sites liés au jeton donné, qui est le compte api_key. Cette API accepte des paramètres pour la recherche, le tri et la pagination pratiques. |
| Obtenir des données de compteurs |
Retourne pour chaque compteur sur le site sa lecture énergétique de durée de vie, ses métadonnées et l’appareil auquel il est connecté. |
| Obtenir la liste des capteurs |
Retourne une liste de tous les capteurs du site et de l’appareil auquel ils sont connectés |
| Puissance du site - Détaillé |
Mesures détaillées de l’alimentation du site à partir de compteurs tels que la consommation, l’exportation (flux), l’importation (achat), etc. |
| Vue d’ensemble du site |
La réponse comprend l’énergie actuelle du site, l’énergie quotidienne, l’énergie mensuelle, l’énergie annuelle et l’énergie de temps de vie. |
| Énergie du site |
Retourner les mesures énergétiques du site |
| Énergie du site - Détaillé |
Mesures détaillées de l’énergie du site à partir de compteurs tels que la consommation, l’exportation (alimentation), l’importation (achat), etc. |
| Énergie du site – Période |
Retournez l’énergie totale du site produite pendant une période donnée. |
Alimentation du site
Renvoyer les mesures d’alimentation du site en résolution de 15 minutes
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Date et heure de début
|
startTime | True | string |
Date et heure de début (aaaa-mm-dd hh :mm :ss) pour obtenir des mesures de puissance |
|
Date et heure de début
|
endTime | True | string |
Date et heure de début (aaaa-mm-dd hh :mm :ss) pour obtenir des mesures de puissance |
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Unité de temps (c’est-à-dire QUARTER_OF_AN_HOUR) |
|
unité
|
power.unit | string |
Unité de mesure (c.-à-d. Watt) |
|
measuredBy
|
power.measuredBy | string |
Source des mesures |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Date et Heure |
|
value
|
power.values.value | float |
Puissance mesurée (c.-à-d. Watt) à datetime spécifiée |
Avantages environnementaux du site
Retourne tous les avantages environnementaux en fonction de la production d’énergie du site : émissions de CO2 économisés, arbres équivalents plantés et ampoules alimentées pendant une journée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Unités
|
envBenefits.gasEmissionSaved.units | string |
unités pour le reste des résultats |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 en Kg ou Lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 en Kg ou Lb |
|
Nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX en kg ou Lb |
|
arbresplantés
|
envBenefits.treesPlanted | float |
Plantation équivalente de nouveaux arbres pour réduire les niveaux de CO2 |
|
Ampoules
|
envBenefits.lightBulbs | float |
nombre d’ampoules qui auraient pu être alimentées par le site pendant une journée |
Données techniques d’onduleur
Retournez des données d’onduleur spécifiques pour une période donnée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Numéro de série de l’équipement
|
equipment_id | True | string |
Numéro de série de l’équipement |
|
Début (date + heure) pour obtenir des données d’inversion
|
startTime | True | string |
Début (date + heure) pour obtenir des données d’inversion |
|
Fin (date + heure) pour obtenir des données d’inversion
|
endTime | True | string |
Fin (date + heure) pour obtenir des données d’inversion |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
count
|
data.count | integer |
Nombre de réponses |
|
télémétrie
|
data.telemetries | array of object |
télémétrie |
|
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 Energy
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
total Energy |
|
température
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Température en Celsius |
|
onduleurMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
État de l’onduleur, c’est-à-dire OFF, STARTING, MPPT, etc. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Entier du mode d’opération 0 sur la grille, 1 Fonctionnement en mode hors-réseau avec pv ou batterie, 2 fonctionnant en mode hors-réseau avec générateur |
|
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 |
|
reactPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reactPower |
|
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 |
|
reactPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reactPower |
|
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 |
|
reactPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reactPower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Détails du site
Affiche les détails du site, tels que le nom, l’emplacement, l’état, etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
details.id | integer |
ID de site |
|
nom
|
details.name | string |
Nom du site |
|
accountId
|
details.accountId | integer |
Compte auquel appartient ce site |
|
status
|
details.status | string |
État des sites |
|
peakPower
|
details.peakPower | float |
Les sites peakPower |
|
monnaie
|
details.currency | string |
Devise des sites |
|
installationDate
|
details.installationDate | string |
Date d’installation du site, format aaaa-mm-dd hh :mm :ss |
|
ptoDate
|
details.ptoDate | string |
Autorisation d’exploitation date |
|
Remarques
|
details.notes | string |
Remarques |
|
type
|
details.type | string |
Type de site |
|
country
|
details.location.country | string |
Pays des sites |
|
city
|
details.location.city | string |
La ville des sites |
|
address
|
details.location.address | string |
Adresse des sites |
|
Adresse2
|
details.location.address2 | string |
Adresse des sites2 |
|
fichier ZIP
|
details.location.zip | string |
Les sites zip |
|
timeZone
|
details.location.timeZone | string |
Fuseau horaire des sites |
|
countryCode
|
details.location.countryCode | string |
Code du pays des sites |
|
alertQuantity
|
details.alertQuantity | integer |
Nombre d’alertes ouvertes dans ce site |
|
alertSeverity
|
details.alertSeverity | string |
Gravité de l’alerte la plus élevée dans ce site |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
URI de l’image de sites |
Flux d’alimentation du site
Récupère le flux d’alimentation actuel entre tous les éléments du site, y compris le réseau PV, le stockage (batterie), les charges (consommation) et la grille.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
unité
|
siteCurrentPowerFlow.unit | string |
Unités de mesure (par exemple, Watt) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
Tableau incluant toutes les relations entre les éléments et les directions de flux d’alimentation (élément de production et élément consommant) |
|
de
|
siteCurrentPowerFlow.connections.from | string |
Élément fournissant de l’alimentation |
|
à
|
siteCurrentPowerFlow.connections.to | string |
L’élément consommant de l’énergie |
|
status
|
siteCurrentPowerFlow.GRID.status | string |
État de la grille (Actif/Inactif/Désactivé) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
Alimentation actuelle de la grille |
|
status
|
siteCurrentPowerFlow.LOAD.status | string |
État de chargement (Actif/ Inactif/ Désactivé) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
Alimentation de charge actuelle |
|
status
|
siteCurrentPowerFlow.PV.status | string |
État pv (Actif/ Inactif/ Désactivé) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
Puissance PV actuelle |
|
status
|
siteCurrentPowerFlow.STORAGE.status | string |
État du stockage (Actif/ Inactif/ Désactivé) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
Puissance de stockage actuelle |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
Frais de stockageLevel |
|
critique
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
Le stockage critique ? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
En mode sauvegarde, heure spécifiée avant l’expiration du stockage |
Informations de stockage
Obtenez des informations détaillées sur le stockage des piles : l’état de l’énergie, de l’énergie et de la durée de vie.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Identificateur de site
|
startTime | True | string |
Identificateur de site |
|
Identificateur de site
|
endTime | True | string |
Identificateur de site |
|
Retourner des données uniquement pour des numéros de série de batterie spécifiques
|
serials | string |
Renvoyer des données uniquement pour des numéros de série de batterie spécifiques, la liste est séparée par des virgules. Si elle est omise, la réponse inclut toutes les batteries du site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
Nombre de batteries inclus dans la réponse |
|
Piles
|
storageData.batteries | array of object |
Liste des objets de batterie |
|
plaque
|
storageData.batteries.nameplate | integer |
Capacité nomplate (nominale) de la batterie |
|
serialNumber
|
storageData.batteries.serialNumber | string |
Numéro de série de la batterie |
|
numéro de modèle
|
storageData.batteries.modelNumber | string |
Numéro du modèle de batterie |
|
telemetryCount
|
storageData.batteries.telemetryCount | integer |
Nombre de télémétries pour cette batterie dans la réponse |
|
télémétrie
|
storageData.batteries.telemetries | array of object |
Liste des télémétries de données de stockage |
|
horodatage
|
storageData.batteries.telemetries.timeStamp | string |
Horodatage de télémétrie au format AAAA -MM-DD HH :MM :SS |
|
pouvoir
|
storageData.batteries.telemetries.power | integer |
La puissance positive indique que la batterie est en charge, négative est décharger |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Peut être l’un des 0 suivants (non valide), 1 (veille), 2 (Mgmt thermique.), 3 (Activé), 4 (Erreur) |
|
lifeTime EnergyCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
L’énergie chargée de la batterie en Wh, pendant la durée de vie de la batterie |
|
lifeTime Energy Décharge
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
L’énergie déchargée de la batterie en Wh, pendant la durée de vie de la batterie |
|
fullPack EnergyAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
Énergie maximale (Wh) qui peut actuellement être stockée dans la batterie |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Température interne de la batterie en Celsius |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Quantité d’énergie AC utilisée pour charger la batterie à partir du réseau dans une plage de dates spécifiée en Wh |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
l’état de charge de la batterie en pourcentage de la capacité disponible. Les valeurs sont comprises entre 0 et 100 |
Inventaire des sites
Retournez l’inventaire des équipements SolarEdge sur le site, y compris les onduleurs/SMIs, les batteries, les compteurs, les passerelles et les capteurs.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Mètres
|
Inventory.meters | array of object |
Liste des compteurs pour le site spécifié |
|
nom
|
Inventory.meters.name | string |
Nom du compteur |
|
manufacturer
|
Inventory.meters.manufacturer | string |
Fabricant du compteur |
|
model
|
Inventory.meters.model | string |
Modèle de compteur |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
FirmwareVersion du compteur |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– Nom de l’appareil SolarEdge à lequel le compteur est connecté |
|
type
|
Inventory.meters.type | string |
Type de compteur, par exemple « Production » |
|
forme
|
Inventory.meters.form | string |
physique pour un compteur HW ou virtuel s’il est calculé par arithmétique entre d’autres compteurs |
|
Capteurs
|
Inventory.sensors | array of object |
Liste des capteurs pour le site spécifié |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– Nom de l’appareil SolarEdge à lequel le capteur est connecté |
|
pièce d'identité
|
Inventory.sensors.id | string |
ID du capteur |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
nom de l’appareil à lequel il est connecté, par exemple « Passerelle 1 » |
|
catégorie
|
Inventory.sensors.category | string |
Catégorie de capteur, par exemple IRRADIANCE |
|
type
|
Inventory.sensors.type | string |
Type de capteur, par exemple « Plan de l’irradiance de tableau » |
|
gateways
|
Inventory.gateways | array of object |
Liste des passerelles pour le site spécifié |
|
nom
|
Inventory.gateways.name | string |
Nom de l’onduleur, par exemple Onduleur 1 |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
La microprogramme d’équipement |
|
SN
|
Inventory.gateways.SN | string |
Numéro de série de l’équipement, par exemple 7F123456-00 |
|
Piles
|
Inventory.batteries | array of object |
Liste des batteries pour le site spécifié |
|
nom
|
Inventory.batteries.name | string |
Nom de la batterie |
|
manufacturer
|
Inventory.batteries.manufacturer | string |
Le fabricant de batteries |
|
model
|
Inventory.batteries.model | string |
Modèle de batterie |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
FirmwareVersion de batterie |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– numéro de série de l’onduleur / passerelle à la batterie est connectée |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
la capacité de la batterie sous forme de nom fournie par le fabricant |
|
SN
|
Inventory.batteries.SN | string |
Numéro de série de la batterie |
|
Onduleurs
|
Inventory.inverters | array of object |
Liste des onduleurs pour le site spécifié |
|
nom
|
Inventory.inverters.name | string |
Le nom de l’onduleur |
|
manufacturer
|
Inventory.inverters.manufacturer | string |
Le fabricant de l’onduleur |
|
model
|
Inventory.inverters.model | string |
Le modèle d’onduleur |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
Microprogramme d’onduleurVersion |
|
SN
|
Inventory.inverters.SN | string |
Numéro de série de l’onduleur |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Nombre d’optimiseurs connectés à l’onduleur |
Journal des modifications d’équipement
Retourne la liste des remplacements de composants d’équipement classés par date. Cette méthode s’applique aux onduleurs, optimiseurs, piles et passerelles.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Numéro de série de l’équipement
|
equipment_id | True | string |
Numéro de série de l’équipement |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Numéro de série court de l’équipement |
|
partNumber
|
ChangeLog.list.partNumber | string |
modèle d’équilibrage de charge/batterie/optimiseur/passerelle |
|
date
|
ChangeLog.list.date | string |
Date de remplacement de ce composant d’équipement |
Liste des composants
Retourner une liste d’onduleurs/PME dans le site spécifique
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
count
|
reporters.count | integer |
Nombre de composants sites |
|
list
|
reporters.list | array of object |
list |
|
componentname
|
reporters.list.componentname | string |
Nom du composant |
|
manufacturer
|
reporters.list.manufacturer | string |
Fabricant de composants |
|
Model
|
reporters.list.Model | string |
Modèle de composant |
|
Numéro de série
|
reporters.list.SerialNumber | string |
Numéro de série du composant |
Liste des sites
Retourne une liste de sites liés au jeton donné, qui est le compte api_key. Cette API accepte des paramètres pour la recherche, le tri et la pagination pratiques.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
count
|
sites.count | integer |
Quantité de sites retournés. |
|
site
|
sites.site | array of object |
site |
|
SiteID
|
sites.site.id | integer |
ID de site. |
|
nom
|
sites.site.name | string |
Nom du site |
|
accountId
|
sites.site.accountId | integer |
Compte auquel appartient ce site |
|
status
|
sites.site.status | string |
État du site |
|
peakPower
|
sites.site.peakPower | float |
Puissance maximale du site |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Date de la dernière mise à jour du site, format aaaa-mm-dd hh :mm :ss |
|
installationDate
|
sites.site.installationDate | string |
Date d’installation du site, format aaaa-mm-dd hh :mm :ss |
|
ptoDate
|
sites.site.ptoDate | string |
Autorisation d’exploitation date |
|
Remarques
|
sites.site.notes | string |
Remarques |
|
type
|
sites.site.type | string |
Type de site |
|
country
|
sites.site.location.country | string |
Pays des sites |
|
city
|
sites.site.location.city | string |
La ville des sites |
|
address
|
sites.site.location.address | string |
Adresse des sites |
|
Adresse2
|
sites.site.location.address2 | string |
Adresse des sites2 |
|
fichier ZIP
|
sites.site.location.zip | string |
Les sites zip |
|
timeZone
|
sites.site.location.timeZone | string |
Fuseau horaire des sites |
|
countryCode
|
sites.site.location.countryCode | string |
Code du pays des sites |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
Primary model manufacturerName |
|
modelName
|
sites.site.primaryModule.modelName | string |
ModelName du modèle principal |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
MaximumPower du modèle principal |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
Température du modèle principal |
Obtenir des données de compteurs
Retourne pour chaque compteur sur le site sa lecture énergétique de durée de vie, ses métadonnées et l’appareil auquel il est connecté.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Granularité d’agrégation
|
timeUnit | string |
La granularité d’agrégation, les valeurs autorisées sont QUARTER_OF_AN_HOUR, HEURE, JOUR, SEMAINE, MOIS, ANNÉE |
|
|
Heure de début mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss
|
startTime | True | string |
Heure de début mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
|
Heure de fin mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss
|
endTime | True | string |
Heure de fin mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
|
Sélectionner des compteurs spécifiques uniquement
|
meters | string |
Sélectionnez uniquement des compteurs spécifiques. Si cette valeur est omise, toutes les lectures de compteur sont retournées. Les valeurs autorisées sont Production, Consommation, FeedIn, Acheté |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Granularité d’agrégation |
|
unité
|
meterEnergyDetails.unit | string |
Unité de compteurs retournés (Wh) |
|
Mètres
|
meterEnergyDetails.meters | array of object |
Valeurs par compteur |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Onduleur auquel le compteur est connecté |
|
model
|
meterEnergyDetails.meters.model | string |
Modèle de compteur |
|
meterType
|
meterEnergyDetails.meters.meterType | string |
Type de compteur Production, Consommation, FeedIn ou Acheté |
|
values
|
meterEnergyDetails.meters.values | array of object |
Valeurs par compteur par date |
|
date
|
meterEnergyDetails.meters.values.date | string |
Horodatage de mesure |
|
value
|
meterEnergyDetails.meters.values.value | float |
Lecture de l’énergie de durée de vie |
Obtenir la liste des capteurs
Retourne une liste de tous les capteurs du site et de l’appareil auquel ils sont connectés
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
Nombre de capteurs de sites |
|
list
|
SiteSensors.list | array of object |
Liste par passerelle |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Nom de la passerelle à l’origine de la connexion du capteur |
|
count
|
SiteSensors.list.count | integer |
Nombre de capteurs de passerelles |
|
Capteurs
|
SiteSensors.list.sensors | array of object |
Capteurs |
|
nom
|
SiteSensors.list.sensors.name | string |
Nom du capteur |
|
mesure
|
SiteSensors.list.sensors.measurement | string |
Que mesure le capteur, par exemple SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
type
|
SiteSensors.list.sensors.type | string |
ce que le capteur mesure, par exemple SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Puissance du site - Détaillé
Mesures détaillées de l’alimentation du site à partir de compteurs tels que la consommation, l’exportation (flux), l’importation (achat), etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Heure de début mesurée par l’énergie
|
startTime | True | string |
Heure de début mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
|
Heure de fin mesurée par l’énergie
|
endTime | True | string |
Heure de fin mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Unité de temps demandée |
|
unité
|
powerDetails.unit | string |
Unités de mesures |
|
Mètres
|
powerDetails.meters | array of object |
Compteurs |
|
type
|
powerDetails.meters.type | string |
Type de compteur (Production/Consommation/SelfConsumption/FeedIn (exportation)/Acheté(import)) |
|
values
|
powerDetails.meters.values | array of object |
Paires de date et de puissance pour chaque date |
|
date
|
powerDetails.meters.values.date | string |
Date et Heure |
|
value
|
powerDetails.meters.values.value | float |
Alimentation pour l’heure de date spécifiée |
Vue d’ensemble du site
La réponse comprend l’énergie actuelle du site, l’énergie quotidienne, l’énergie mensuelle, l’énergie annuelle et l’énergie de temps de vie.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energy
|
overview.lifeTimeData.energy | float |
Numéro d’énergie de durée de vie |
|
energy
|
overview.lastYearData.energy | float |
Numéro d’énergie de l’année dernière |
|
energy
|
overview.lastMonthData.energy | float |
Numéro d’énergie |
|
energy
|
overview.lastDayData.energy | float |
Numéro d’énergie du dernier jour |
|
pouvoir
|
overview.currentPower.power | float |
Numéro d’alimentation actuel |
|
measuredBy
|
overview.measuredBy | string |
Mesuré par |
Énergie du site
Retourner les mesures énergétiques du site
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Granularité d’agrégation
|
timeUnit | True | string |
La granularité d’agrégation, les valeurs autorisées sont QUARTER_OF_AN_HOUR, HEURE, JOUR, SEMAINE, MOIS, ANNÉE |
|
Date de début pour retourner la mesure de l’énergie
|
startDate | True | string |
Date de début pour retourner la mesure de l’énergie |
|
La date de fin renvoie la mesure de l’énergie
|
endDate | True | string |
La date de fin renvoie la mesure de l’énergie |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Unité de temps demandée |
|
unité
|
energy.unit | string |
Unités de mesure |
|
measuredBy
|
energy.measuredBy | string |
Source des mesures |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Date et Heure |
|
value
|
energy.values.value | float |
Puissance mesurée (c.-à-d. Watt) à datetime spécifiée |
Énergie du site - Détaillé
Mesures détaillées de l’énergie du site à partir de compteurs tels que la consommation, l’exportation (alimentation), l’importation (achat), etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Granularité d’agrégation
|
timeUnit | True | string |
La granularité d’agrégation, les valeurs autorisées sont QUARTER_OF_AN_HOUR, HEURE, JOUR, SEMAINE, MOIS, ANNÉE |
|
Heure de début mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss
|
startTime | True | string |
Heure de début mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
|
Heure de fin mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss
|
endTime | True | string |
Heure de fin mesurée par l’énergie au format aaaa-MM-DD hh :mm :ss |
|
Sélectionner des compteurs spécifiques uniquement
|
Meters | True | string |
Sélectionnez des compteurs spécifiques uniquement si tout est vide. Les valeurs autorisées sont PRODUCTION, CONSUMPTION, SelfConsumption, FeedIn, Acheté |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Unité de temps demandée |
|
unité
|
energyDetails.unit | string |
Unités de mesure |
|
Mètres
|
energyDetails.meters | array of object |
Mètres |
|
type
|
energyDetails.meters.type | string |
type |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Date et Heure |
|
value
|
energyDetails.meters.values.value | float |
Puissance mesurée (c.-à-d. Watt) à datetime spécifiée |
Énergie du site – Période
Retournez l’énergie totale du site produite pendant une période donnée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de site
|
site_id | True | integer |
Identificateur de site |
|
Date de début pour retourner la mesure de l’énergie
|
startDate | True | string |
Date de début pour retourner la mesure de l’énergie |
|
La date de fin renvoie la mesure de l’énergie
|
endDate | True | string |
La date de fin renvoie la mesure de l’énergie |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
Résumé de l’énergie |
|
unité
|
timeFrameEnergy.unit | string |
Unité énergétique (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
Source des mesures |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Informations de date de début fournies |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Énergie de la date de début |
|
unité
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Unité de date de début (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Informations de date de fin fournies |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Énergie de date de fin |
|
unité
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Unité de date de fin (Wh) |