Intégrations : API LF Cloud, webhooks, Modbus et GTB/SCADA
Les données sortent de LF Cloud de trois façons : votre système les extrait par l'API REST (Retriever pour les mesures des capteurs, Consumption pour les données des compteurs), LF Cloud pousse chaque nouvelle mesure vers votre serveur par le webhook Active Forwarding, ou les rapports s'exportent en PDF ou Excel selon un horaire. Les données entrent depuis les enregistreurs eux-mêmes et, pour les équipements Modbus RTU et M-Bus, par MODGATE et le LF M-Bus Cloud Bridge. Une GTB, un SCADA ou un ERP se branche par l'API ou le webhook; les identifiants et les spécifications des points de terminaison sont émis par compte une fois l'intégration définie.
Mis à jour:
Ce que vous pouvez extraire, envoyer et brancher
| Interface | Sens | Fonction | Format et limites |
|---|---|---|---|
| Retriever API | Extraction (REST) | La dernière mesure, le premier relevé, n'importe quelle mesure par horodatage, ou tous les relevés d'une période que vous choisissez. | JSON avec température, humidité, tension, force du signal et plus. Appareils EDGE et BLOCK. 1 appel par numéro de série par minute. |
| Consumption API | Extraction (REST) | Consommation agrégée d'eau, de gaz naturel, d'électricité, de chauffage ou de climatisation, pour tous les compteurs du compte ou un numéro de série, sur une période précise à l'heure près. | m³ pour l'eau et le gaz, kWh pour l'électricité, avec un indice de fiabilité par relevé. Conçue pour la facturation et les audits énergétiques. |
| Active Forwarding API | Envoi (webhook) | LF Cloud publie chaque nouvelle mesure sur votre serveur dès sa synchronisation, et transmet par lots quand l'historique stocké est téléversé depuis la mémoire de l'appareil. Aucune interrogation périodique. | Webhook HTTP standard; JSON avec numéro de série, identifiant de l'appareil et toutes les valeurs des capteurs. Vous définissez l'URL du point de terminaison et le jeton de sécurité dans le tableau de bord. |
| Provisionnement | Envoi vers LF Cloud (REST) | Enregistrer des appareils et pousser leur configuration par programmation, pour que la mise en service suive la taille du déploiement. | Identifiants propres au compte, émis une fois l'intégration définie. |
| Rapports | Exportation | Toute période en PDF ou Excel, ou programmée pour un envoi automatique par courriel, pour qu'un fichier arrive dans une boîte de réception sans que personne ne se connecte. | Comprend la température cinétique moyenne (MKT) et les rapports min/max/moyenne. |
| MODGATE | Modbus RTU vers LF Cloud | Lit les registres d'un appareil Modbus RTU sur RS485 et envoie les valeurs décodées à LF Cloud par WiFi ou cellulaire, avec les mêmes alarmes que tout capteur LoggerFlex. | Registres configurables. Usages types : heures de marche et niveau de carburant des génératrices, production des onduleurs solaires. |
| LF M-Bus Cloud Bridge | M-Bus vers LF Cloud | Lit les compteurs M-Bus filaires, comme maître M-Bus et Modbus, et transmet les relevés à LF Cloud par réseau local ou WiFi. | Pour le sous-comptage des services publics et le comptage industriel et CVC. |
Authentification et limites
- Les identifiants API et les spécifications des points de terminaison sont fournis par compte une fois l'intégration définie. Aucun secret, aucune clé ni URL de point de terminaison n'est publié sur ce site.
- Les webhooks utilisent une authentification sécurisée par jeton, avec un secret que vous définissez.
- Premium Access comprend 2 000 appels API par année, et chaque appareil inclut sa première année de Premium. La Retriever API permet 1 appel par numéro de série par minute.
- Les données de chaque appareil vont directement aux serveurs de LoggerFlex au Canada (Montréal), par TLS 1.3 avec contrôle d'accès par rôle.
GTB, SCADA et ERP
Les enregistreurs n'ont pas à être sur le réseau de votre bâtiment ou de votre usine : ils joignent LF Cloud par eux-mêmes en WiFi ou LTE, sans passerelle. Votre GTB, SCADA, ERP ou tableau de bord maison récupère ensuite les données dans LF Cloud, poussées par le webhook à mesure qu'elles arrivent ou extraites selon son propre horaire par la Retriever API ou la Consumption API.
Dans l'autre sens, MODGATE et le LF M-Bus Cloud Bridge intègrent à LF Cloud les équipements de terrain qui parlent Modbus RTU ou M-Bus; leurs données y sont affichées, incluses dans les rapports et surveillées par alarmes avec celles des capteurs LoggerFlex.
Comment démarrer une intégration
- Indiquez à un ingénieur quel système reçoit les données, quels appareils ou compteurs l'alimentent, et s'il doit extraire les données ou les recevoir.
- Nous définissons l'intégration et fournissons vos identifiants et la documentation API pour votre compte.
- Pour la transmission, entrez l'URL de votre point de terminaison et votre jeton de sécurité dans le tableau de bord; les mesures arrivent dès la prochaine synchronisation.
Questions fréquentes
LF Cloud a-t-il une API?
Oui. LF Cloud offre une API REST documentée : la Retriever API extrait l'historique ou les dernières mesures des capteurs en JSON, la Consumption API extrait les données des compteurs, et les appels de provisionnement enregistrent et configurent les appareils. Les identifiants et les spécifications des points de terminaison sont émis par compte une fois l'intégration définie; aucune clé ni URL n'est publiée sur le site.
LF Cloud peut-il envoyer les mesures à notre propre serveur?
Oui, par l'Active Forwarding API. LF Cloud publie chaque nouvelle mesure sur un point de terminaison HTTP que vous contrôlez dès sa synchronisation, et transmet l'historique stocké par lots quand un appareil téléverse sa mémoire. Le contenu JSON comprend le numéro de série, l'identifiant de l'appareil et toutes les valeurs des capteurs, et vous définissez le jeton de sécurité.
Combien d'appels API sont inclus?
Premium Access comprend 2 000 appels API par année, et chaque appareil inclut sa première année de Premium. La Retriever API est limitée à 1 appel par numéro de série par minute. La transmission par webhook ne demande aucune interrogation.
LoggerFlex peut-il intégrer nos équipements Modbus ou M-Bus à LF Cloud?
Oui. MODGATE lit les registres Modbus RTU sur RS485 et les envoie à LF Cloud par WiFi ou cellulaire, et le LF M-Bus Cloud Bridge lit les compteurs M-Bus filaires par réseau local ou WiFi. Leurs relevés sont affichés en graphiques, inclus dans les rapports et surveillés par alarmes comme tout capteur LoggerFlex, et votre GTB ou SCADA les récupère par l'API ou le webhook.