Integraciones: API de LF Cloud, webhooks, Modbus y BMS/SCADA
Los datos salen de LF Cloud de tres formas: su sistema los extrae con la API REST (Retriever para lecturas de sensores, Consumption para datos de medidores), LF Cloud envía cada nueva lectura a su servidor con el webhook Active Forwarding, o los informes se exportan en PDF o Excel de forma programada. Los datos entran desde los propios registradores y, para equipos Modbus RTU y M-Bus, a través de MODGATE y el LF M-Bus Cloud Bridge. Un BMS, SCADA o ERP se conecta por la API o el webhook; las credenciales y las especificaciones de los endpoints se emiten por cuenta una vez definida la integración.
Actualizado:
Qué puede extraer, enviar y conectar
| Interfaz | Dirección | Función | Formato y límites |
|---|---|---|---|
| Retriever API | Extracción (REST) | La última lectura, el primer registro, cualquier lectura por marca de tiempo o todos los registros de un periodo que usted elija. | JSON con temperatura, humedad, voltaje, intensidad de señal y más. Equipos EDGE y BLOCK. 1 llamada por número de serie por minuto. |
| Consumption API | Extracción (REST) | Consumo agregado de agua, gas natural, electricidad, calefacción o refrigeración, para todos los medidores de la cuenta o un número de serie, en un periodo con precisión de una hora. | m³ para agua y gas, kWh para electricidad, con un índice de confiabilidad por lectura. Pensada para facturación y auditorías energéticas. |
| Active Forwarding API | Envío (webhook) | LF Cloud publica cada nueva lectura en su servidor en cuanto se sincroniza, y reenvía por lotes cuando se carga el historial guardado en la memoria del equipo. Sin consultas periódicas. | Webhook HTTP estándar; JSON con número de serie, ID del equipo y todos los valores de los sensores. Usted define la URL del endpoint y el token de seguridad en el panel de la nube. |
| Aprovisionamiento | Envío hacia LF Cloud (REST) | Registrar equipos y enviar su configuración de forma programática, para que la puesta en marcha crezca con el despliegue. | Credenciales por cuenta, emitidas una vez definida la integración. |
| Informes | Exportación | Cualquier periodo en PDF o Excel, o programado para envío automático por correo, para que un archivo llegue a una bandeja de entrada sin que nadie inicie sesión. | Incluye la temperatura cinética media (MKT) y los informes de mín/máx/promedio. |
| MODGATE | Modbus RTU hacia LF Cloud | Lee los registros de un equipo Modbus RTU por RS485 y envía los valores decodificados a LF Cloud por WiFi o celular, con las mismas alarmas que cualquier sensor LoggerFlex. | Registros configurables. Usos típicos: horas de funcionamiento y nivel de combustible de generadores, producción de inversores solares. |
| LF M-Bus Cloud Bridge | M-Bus hacia LF Cloud | Lee medidores M-Bus cableados, como maestro M-Bus y Modbus, y lleva las lecturas a LF Cloud por LAN o WiFi. | Para submedición de servicios y medición industrial y de HVAC. |
Autenticación y límites
- Las credenciales de la API y las especificaciones de los endpoints se entregan por cuenta una vez definida la integración. En este sitio no se publican secretos, claves ni URL de endpoints.
- Los webhooks usan autenticación segura por token, con un secreto que usted define.
- Premium Access incluye 2000 llamadas a la API por año, y cada equipo incluye su primer año de Premium. La Retriever API permite 1 llamada por número de serie por minuto.
- Los datos de cada equipo van directamente a los servidores de LoggerFlex en Canadá (Montreal), por TLS 1.3 con acceso basado en roles.
BMS, SCADA y ERP
Los registradores no tienen que estar en la red de su edificio o planta: llegan a LF Cloud por sí solos por WiFi o LTE, sin gateway. Su BMS, SCADA, ERP o panel propio toma luego los datos de LF Cloud, enviados por el webhook a medida que llegan o extraídos con su propio calendario mediante la Retriever API o la Consumption API.
En la otra dirección, MODGATE y el LF M-Bus Cloud Bridge llevan a LF Cloud los equipos de campo que hablan Modbus RTU o M-Bus, donde se grafican, se incluyen en informes y activan alarmas junto con los sensores LoggerFlex.
Cómo iniciar una integración
- Indique a un ingeniero qué sistema recibe los datos, qué equipos o medidores lo alimentan y si debe extraer los datos o recibirlos.
- Definimos la integración y le entregamos las credenciales y la documentación de la API para su cuenta.
- Para el reenvío, ingrese la URL de su endpoint y su token de seguridad en el panel de la nube; las lecturas llegan desde la siguiente sincronización.
Preguntas frecuentes
¿LF Cloud tiene una API?
Sí. LF Cloud ofrece una API REST documentada: la Retriever API extrae el historial o las últimas lecturas de los sensores en JSON, la Consumption API extrae los datos de medidores, y las llamadas de aprovisionamiento registran y configuran equipos. Las credenciales y las especificaciones de los endpoints se emiten por cuenta una vez definida la integración; no se publican claves ni URL en el sitio web.
¿Puede LF Cloud enviar las lecturas a nuestro propio servidor?
Sí, con la Active Forwarding API. LF Cloud publica cada nueva lectura en un endpoint HTTP que usted controla en cuanto se sincroniza, y reenvía el historial guardado por lotes cuando un equipo carga su memoria. El contenido JSON incluye el número de serie, el ID del equipo y todos los valores de los sensores, y usted define el token de seguridad.
¿Cuántas llamadas a la API están incluidas?
Premium Access incluye 2000 llamadas a la API por año, y cada equipo incluye su primer año de Premium. La Retriever API está limitada a 1 llamada por número de serie por minuto. El reenvío por webhook no necesita consultas periódicas.
¿Puede LoggerFlex integrar nuestros equipos Modbus o M-Bus en LF Cloud?
Sí. MODGATE lee registros Modbus RTU por RS485 y los envía a LF Cloud por WiFi o celular, y el LF M-Bus Cloud Bridge lee medidores M-Bus cableados por LAN o WiFi. Sus lecturas se grafican, se incluyen en informes y activan alarmas como cualquier sensor LoggerFlex, y su BMS o SCADA las recupera por la API o el webhook.