FlexiO API
Utilisation de l'API FlexiO
Votre FlexiObox une API locale API votre réseau domestique. Si vous aimez connecter des appareils à un système domotique, créer un tableau de bord énergétique local ou simplement récupérer des données en temps réel sur votre batterij, voici comment procéder.
Qu'est-ce que API FlexiO ?
API FlexiO API une interface de lecture qui s'exécute directement sur votre FlexiObox. Elle vous permet d'accéder à des mesures en temps réel (telles que batterij de charge batterij , la production solaire, l'alimentation du réseau et les prix de l'électricité) sans passer par le cloud.
À qui s'adresse ce produit ?
Cette page s'adresse aux FlexiO avancés FlexiO qui souhaitent connecter leur système à des outils locaux, tels que Home Assistant, Node-RED, un tableau de bord Grafana ou toute autre plateforme domotique capable d'effectuer des requêtes HTTP.
Il n'est pas nécessaire d'être développeur, mais vous devez être à l'aise avec des concepts tels que les adresses IP, API et les réponses JSON.
LIFEPOWR n' assure aucune assistance pour la configuration deAPI FlexiO API votre réseau local. Cette fonctionnalité est réservée aux FlexiO ayant des compétences techniques.
Ce que vous pouvez en faire
API FlexiO API trois fonctionnalités :
Informations sur l'appareil: Vérifiez la version FlexiObox et le nom de votre FlexiObox .
Mesures énergétiques en temps réel : consultez en direct les données du système de gestion de l'énergie, telles que la production solaire, l'état batterij, le réseau, la consommation domestique, etc. Mises à jour en continu, sans passage par le cloud.
Paramètres de gestion de la charge: lire (et, dans un cas, modifier) les paramètres génériques de gestion de la charge. Utile si vous gérez une charge externe, par exemple une pompe à chaleur, en fonction de la disponibilité de l'énergie ou du prix de l'électricité. Pour plus d'informations, cliquez ici.
Avant de commencer
Assurez-vous que :
Votre FlexiObox allumée et connectée à votre réseau local.
L'appareil que vous utilisez pour appeler API sur le même réseau que la FlexiObox.
Vous pouvez contacter api dans un navigateur. Si la page s'affiche, tout va bien.
Si myio.local si cela ne fonctionne pas, essayez de trouver l'adresse FlexiObox dans la liste des appareils de votre routeur et utilisez-la à la place (par exemple, http://192.168.1.xx/api).
Points de terminaison disponibles
Access to API via http://myio.local/api/<endpoint>
Par exemple :api
Mesure | Unités | Description | Point d'extrémité | Méthode |
|---|---|---|---|---|
courant de batterie filtré | kW | Consommation de courant de la batterie | api | OBTENIR |
tension_batterie_avant_filtrage | kW | Tension de la batterie | api | OBTENIR |
Puissance d'entrée totale filtrée | kW | Mesure de la puissance filtrée provenant de l'onduleur | api | OBTENIR |
Charger la puissance filtrée | kW | Consommation électrique du foyer | api | OBTENIR |
MeterPowerFiltré | kW | Puissance totale injectée/prélèvement sur le réseau | api | OBTENIR |
totalPVPowerFiltré | kW | Puissance photovoltaïque totale produite – y compris les installations hybrides et les rénovations | api | OBTENIR |
étatDeChargeFiltré | % | État de charge de la batterie | api | OBTENIR |
état de santé filtré | % | État de santé de la batterie | api | OBTENIR |
consigne de puissance | kW | Consigne de puissance à envoyer au variateur | api | OBTENIR |
Consommation d'électricité Prix | €/kWh | Prix actuel de l'électricité utilisé pour les calculs | api | OBTENIR |
powerSetpointGeneric | kW | Puissance disponible pour commander une charge standard | api | OBTENIR |
prix maximal de l'électricité | €/kWh | Prix maximal de l'électricité applicable dans le cadre d'une gestion générique de la charge | api | GET/PUT |
Bon à savoir
Accès local uniquement. API accessible depuis l'extérieur de votre réseau domestique. Si vous avez besoin d'un accès à distance, vous devrez le configurer vous-même sur votre routeur (VPN, redirection de ports, etc.) — mais nous ne prenons pas officiellement en charge cette configuration et ne la recommandons pas.
En temps réel, pas historiques. API uniquement les valeurs actuelles. Pour les données historiques, les graphiques et les tendances, utilisez FlexiO .
Toujours active. API disponible tant que votre FlexiObox en marche — aucune activation ni configuration n'est nécessaire de votre part.
Documentation Swagger sur l'appareil. Rendez-vous sur api pour consulter la API interactive complète, y compris les schémas de requêtes/réponses.