Onduleurs Sungrow surveillés via l’API Open iSolarCloud
Appareils pris en charge
| Device Type |
|---|
| All Sungrow inverters registered in iSolarCloud |
Étapes de configuration
Prérequis : chaque onduleur a déjà été ajouté à votre compte iSolarCloud et est visible dans le portail web ou l’application mobile.
-
Récupérer les identifiants API
iSolarCloud → Settings → Open API vous fournit :
API Key, Access Key et RSA Key. -
Créer un utilisateur en lecture seule (recommandé)
Dans Users & Roles, ajoutez un utilisateur « API » dédié et limitez ses droits à Read. -
Ajouter le pilote dans SmartgridOne
-
Integrations → Add device
-
Choisissez iSolarCloud API
-
Remplissez les champs :
Champ Exemple Nom d’utilisateur / Mot de passe api_user / S3cureP@ssAPI Key / Access Key / RSA Key valeurs de l’étape 1 Filtre de localisation 100;101(facultatif – liste séparée par des points-virgules)Type de commande par défaut (limitation de la puissance active)
Enregistrez – chaque onduleur appartenant aux sites sélectionnés apparaîtra automatiquement.
-
Mesures exposées
| Clé | Description | Unité |
|---|---|---|
actualPowerTot_W | Puissance AC instantanée de la centrale photovoltaïque | W |
producedEnergyDeltaTot_Wh | Énergie photovoltaïque depuis la précédente lecture ¹ | Wh |
importedEnergyDeltaTot_Wh | Énergie importée du réseau (si fournie par Sungrow) | Wh |
exportedEnergyDeltaTot_Wh | Énergie exportée vers le réseau (injection) | Wh |
¹ Le pilote intègre la puissance au fil du temps lorsque les compteurs absolus en kWh ne sont pas disponibles.
Dépannage
- HTTP 401 / 403 – vérifiez les identifiants API et que l’accès API est activé pour l’utilisateur dans iSolarCloud.
- Aucun onduleur détecté – vérifiez la liste des ID de localisation ; laissez le champ vide pour récupérer toutes les centrales associées au compte.
- Écrêtement ignoré – certains anciens firmwares Sungrow ne respectent pas les limites de puissance active ; basculez le pilote en mode de commande Alternative (ON/OFF) dans les paramètres.
Ressources utiles
- Documentation de l’Open API – visible après connexion à l’adresse
portail / Open API - Support technique Sungrow – service@sungrowpower.com
Last updated March 10, 2026Edit this page
