Dispositivos conectados · API HTTP
Node-RED, Home Assistant o su script, conectados al mantenimiento
Muchas plantas ya leen sus medidores en algún sitio: un flujo de Node-RED que consulta un analizador Modbus, una instancia de Home Assistant con una docena de sensores, un gateway de PLC, un script de Python en un pequeño PC. FreeMaint Connect permite que cualquiera de ellos envíe sus valores con una sola petición HTTP, para que esas mediciones lleguen por fin a los activos, las alertas y las órdenes de trabajo.
Free your maintenance · Plan Core gratuito, usuarios ilimitados, sin tarjeta de crédito.
En resumen
FreeMaint Connect acepta mediciones de todo sistema que envíe JSON por HTTP: Node-RED, Home Assistant, un gateway Modbus o de PLC, un router Teltonika o un script. Cada petición lleva una clave de acceso en una cabecera y enumera dispositivos y valores; FreeMaint convierte las unidades, crea los canales con el primer mensaje y las reglas de alerta, los contadores de horas y los medidores de energía los usan como los de un dispositivo certificado.
Actualizado el 16 de octubre de 2026
Qué le ofrece la API HTTP
Una petición, muchos dispositivos
Un solo POST puede transportar hasta 500 dispositivos y 5.000 valores, cada uno con su propia hora. Los dispositivos y los canales se crean automáticamente con su primer mensaje.
Incluido en BusinessUnidades convertidas automáticamente
Envíe la energía en Wh, kWh o MWh, las temperaturas en °C o °F, la velocidad de vibración en mm/s o in/s: FreeMaint guarda cada magnitud en una única unidad, para que los valores de sistemas distintos sumen correctamente.
Incluido en BusinessContadores tratados como contadores
Marque un valor como acumulado (un total de energía, un contador de horas de funcionamiento) y FreeMaint calcula el consumo entre lecturas, incluso después de una puesta a cero.
Incluido en BusinessLas mismas alertas y órdenes de trabajo que cualquier dispositivo
En cuanto llega un valor, es un canal como cualquier otro: reglas de alerta, zonas de vibración ISO 20816, horas de funcionamiento, vínculos con medidores del activo y de energía, y la vista en vivo en la app móvil.
Incluido en BusinessUna clave por conexión
Cada conexión tiene su propia clave de acceso, enviada en una cabecera y nunca en la URL. Puede renovarla en cualquier momento, manteniendo la anterior válida durante 24 horas o revocándola de inmediato.
Incluido en BusinessCuándo la API HTTP es el camino adecuado
FreeMaint decodifica por sí mismo unos pocos dispositivos: los medidores de energía Shelly y dos sensores LoRaWAN de Milesight. Todo lo demás pasa por la API HTTP, y eso cubre la mayor parte de una planta industrial: un analizador de redes Modbus leído por Node-RED, un sensor de Home Assistant, un sistema de gestión técnica del edificio que exporta sus puntos, un PLC que ya publica sus contadores, un sensor de vibración leído por su propio gateway.
FreeMaint no habla Modbus, MQTT, BACnet ni OPC UA directamente. Es una decisión deliberada: el gateway que ya está en su red conoce el protocolo y el mapa de registros, y FreeMaint solo necesita los valores. Un flujo de Node-RED o un script corto que convierte registros en JSON suele ocupar unas pocas líneas.
- Flujos de Node-RED que leen equipos Modbus RTU o TCP
- Automatizaciones de Home Assistant que reenvían sensores
- Routers Teltonika con Data to Server
- Gateways de PLC y de gestión técnica de edificios
- Scripts en un pequeño PC o una Raspberry Pi
Cómo es una petición
La petición es un POST a la URL que muestra FreeMaint al crear la conexión, con dos cabeceras: Authorization, que lleva la clave de acceso, y Content-Type con el valor application/json. El cuerpo enumera elementos: cada elemento es un identificador de dispositivo, un nombre visible y una hora opcionales, y sus puntos. Un punto tiene una clave como power o energy_total, un valor e, idealmente, una unidad, una magnitud y, para los contadores, el tipo acumulado.
FreeMaint responde 202 cuando acepta los datos y los guarda en cuestión de segundos. Una petición mal formada recibe una respuesta 400 que nombra el problema, de modo que un gateway mal configurado se corrige en minutos en lugar de descubrirse semanas después. Cada conexión acepta hasta 120 peticiones por minuto; por encima, FreeMaint responde 429 y su sistema debe reintentar más tarde.
Horas de funcionamiento y energía desde su propio sistema
Si su PLC ya cuenta las horas de funcionamiento, envíe el contador como valor acumulado y vincule el canal al medidor de horas de funcionamiento del activo: los planes preventivos se dispararán con él. Si solo informa de potencia o de corriente, deje que FreeMaint calcule las horas de funcionamiento a partir de ese canal. Para la energía, vincule el canal a un medidor de energía y FreeMaint registrará una lectura cada 15 minutos con su coste y su CO2.
Planes y límites
La API HTTP forma parte de FreeMaint Connect, en el plan Business a 99 USD al mes por empresa, tarifa plana, con 100 canales activos. El plan Enterprise incluye 5.000. Un canal inactivo no cuenta, y los datos ya recibidos siguen visibles en todos los planes. Para leer y escribir el resto de FreeMaint (órdenes de trabajo, activos, repuestos) existe además una API GraphQL en Business y webhooks salientes firmados desde Starter.
Envíe sus primeros valores en cuatro pasos
- 1
Cree la conexión
En Dispositivos conectados → Integraciones, haga clic en Conectar un dispositivo y elija API HTTP (Node-RED, script…).
- 2
Copie la URL y la clave
FreeMaint muestra la URL, las dos cabeceras y un cuerpo de ejemplo. La clave se muestra una sola vez.
- 3
Envíe una petición
Desde Node-RED, Home Assistant o su script, haga un POST del JSON con las dos cabeceras.
- 4
Use los canales
Asocie el nuevo dispositivo a su activo, añada reglas de alerta y vincule los canales a los medidores.
Preguntas frecuentes
¿FreeMaint puede leer mi medidor Modbus directamente?
No. Un gateway lee los registros Modbus (Node-RED, Home Assistant, un router Teltonika o un script) y envía los valores a FreeMaint en JSON por HTTPS.
¿Se admite MQTT?
No directamente. Un gateway que se suscriba a sus topics MQTT, como Node-RED, puede reenviar los valores a la API HTTP.
¿Cuántos valores puede llevar una petición?
Hasta 500 dispositivos y 5.000 puntos por petición, y hasta 120 peticiones por minuto por conexión.
¿Qué pasa si mi petición es incorrecta?
FreeMaint responde 400 y nombra el problema, para que pueda corregir el gateway de inmediato. Los datos aceptados reciben un 202.
¿Los valores de mi script pueden abrir órdenes de trabajo?
Sí. En cuanto llega un valor, es un canal: una regla de alerta con Crear una orden de trabajo marcado abre una orden de trabajo en el activo.
¿Qué plan necesito?
Business, a 99 USD al mes por empresa, con 100 canales activos. Enterprise incluye 5.000.
Páginas relacionadas
Aproveche los datos que ya tiene
Empiece con el plan gratuito Core y pase a Business cuando esté listo para enviar mediciones.
Crear mi cuenta gratis