Un único endpoint JSON, todas las plataformas
Home Assistant se lleva la mayor parte de la atención — comprensible, es la plataforma domótica más extendida, y le hemos dedicado una guía entera. Pero el mecanismo real por debajo es deliberadamente simple: un único endpoint HTTP, GET /api.json?key=… (la clave de acceso que aparece en los Settings del dispositivo), JSON plano de vuelta. Cualquier cosa capaz de hacer una petición HTTP y analizar JSON puede extraer de ahí los datos de la batería Pylontech. Eso incluye Jeedom, Node-RED, Domoticz, openHAB, Grafana, un script de Python, una tarea cron con curl — todos leyendo exactamente el mismo dato, ninguno necesita un SDK propietario ni una clave API.

El cable que encadena la batería maestra con la primera esclava debe salir del LINK PORT 1 de la maestra, nunca del LINK PORT 0. Se conecta al LINK PORT 0 de la esclava, y cada batería siguiente repite el mismo esquema 1 → 0. Al revés, la maestra nunca ve el resto de la pila y el Pylon-Monitor solo mostrará una batería, por muchas que tengas.
Jeedom
Jeedom no necesita un plugin Pylontech dedicado. Instale el plugin estándar JSON desde la tienda de Jeedom, apunte un equipo a http://<ip-dispositivo>/api.json?key=<access-key>, y asocie rutas JSON a comandos — summary>soc, summary>voltage, summary>state, net>rssi, etc. Un intervalo de sondeo de 30–60 segundos es más que suficiente; la telemetría de la batería no cambia lo bastante rápido como para necesitar algo más ajustado.
Node-RED
Dos opciones, que reflejan casi exactamente la elección en Home Assistant. Consultar con un nodo http request (método GET, URL http://<ip-dispositivo>/api.json?key=<access-key>, tipo de retorno "a parsed JSON object"), activado por un nodo inject con temporizador, y leer campos como msg.payload.summary.soc más adelante en el flujo. O, si MQTT ya está configurado en el dispositivo, suscribirse directamente a pylon-monitor/state con un nodo MQTT-in en su lugar — las actualizaciones llegan según ocurren, sin bucle de sondeo que gestionar.
Domoticz
Domoticz no trae de fábrica un tipo de sensor nativo de sondeo JSON, pero la solución habitual está bien probada: un pequeño script (Python, o el propio scripting de eventos Lua/Blockly de Domoticz) obtiene /api.json con un temporizador y envía los valores a sensores Dummy/Virtual a través de la propia API JSON de Domoticz. Requiere unos minutos más de configuración que Jeedom o Node-RED, pero es una tarea de una sola vez, y los sensores se comportan después exactamente como cualquier otro dispositivo Domoticz — gráficos de historial completos, notificaciones, todo.
openHAB
El HTTP Binding de openHAB lo gestiona de forma nativa: defina un Thing que apunte a http://<ip-dispositivo>/api.json?key=<access-key> con un intervalo de actualización, y luego asocie canales individuales a rutas JSON mediante una transformación (JSONPath) para extraer summary.soc, summary.voltage, etc. en Items separados. No hace falta un binding personalizado — el binding HTTP genérico lo cubre.
Tuya / SmartLife — un puente no oficial vía IFTTT, Make.com o Apilio
Los dispositivos Tuya y la app SmartLife solo se comunican con la nube propia de Tuya — no hay un endpoint JSON genérico de su lado como aquí, y no existe una integración oficial Pylontech-Tuya. Este dispositivo tampoco pretende serlo. Lo que sí ofrece es la pieza que falta para un puente sin código: active Settings > Public JSON access > "Enable a real public URL" y pylon-monitor.com vuelve a publicar el JSON de su dispositivo en un enlace HTTPS estable, accesible desde cualquier lugar — sin redirección de puertos, sin VPN, sin nada expuesto en su propio router.
Con esa URL en mano, una plataforma de automatización sin código (con nivel gratuito) puede consultarla y enviar los valores a un dispositivo virtual Tuya o a un webhook orientado a SmartLife:
- IFTTT — un applet Webhooks/JSON que consulta la URL según una programación, alimentando una acción de SmartLife.
- Make.com (antes Integromat) — un módulo HTTP que lee la URL, un analizador JSON, y luego un módulo Tuya/SmartLife o un webhook de vuelta a la plataforma IoT de Tuya.
- Apilio — construido específicamente en torno a automatizaciones Tuya/SmartLife, con su propio disparador de solicitud HTTP que puede consultar directamente una URL como esta.
Nada de esto está oficialmente soportado por Tuya ni por Pylon-Monitor — es un puente que usted mismo ensambla con herramientas gratuitas existentes, no una integración certificada. Pero si quiere el SOC o el estado de su batería en un panel de SmartLife, o en una rutina de Alexa/Google que solo entiende dispositivos Tuya, la URL pública de arriba es la pieza que le faltaba.
Grafana, scripts y cualquier otra cosa
Si una herramienta tiene una fuente de datos "JSON API" o "HTTP" —el plugin JSON API de Grafana, la entrada HTTP de Telegraf, un script de Python con requests, una línea de shell con curl | jq— puede leer este endpoint de la misma manera. Esto no es deliberadamente un jardín vallado: al dispositivo no le importa qué hay al otro lado de la petición HTTP, lo que significa que no se vuelve obsoleto el día que cambie de plataforma domótica.
Sondeo vs. MQTT: qué usar y dónde
La mayoría de las plataformas anteriores sondean por defecto la API JSON con un temporizador, lo cual es simple y funciona en todas partes. Si su plataforma también habla MQTT (Node-RED y Home Assistant lo hacen de forma nativa), suscribirse a pylon-monitor/state en su lugar significa que las actualizaciones llegan en el momento en que se publican en lugar de esperar al siguiente sondeo — y además obtiene gratis el topic de disponibilidad retenido, para saber de inmediato si el propio dispositivo se ha desconectado en lugar de adivinarlo por un valor obsoleto. Aun así, sondear cada 30–60 segundos es más que suficiente para cualquier cosa relacionada con la batería — no son datos que se beneficien de una latencia de menos de un segundo.
Preguntas frecuentes
- ¿La monitorización Pylontech funciona con Jeedom?
- Sí. El plugin JSON estándar disponible en la tienda de Jeedom puede consultar directamente el endpoint /api.json del dispositivo y asociar campos a comandos — no se necesita ningún plugin Jeedom personalizado.
- ¿Puedo conectar una batería Pylontech a Node-RED?
- Sí, de dos formas: consultar /api.json con un nodo http request, o suscribirse al topic de estado MQTT con un nodo MQTT-in si MQTT está configurado en el dispositivo.
- ¿Esto también funciona con Domoticz u openHAB?
- Sí. Domoticz normalmente usa un pequeño script para enviar valores a sensores Dummy/Virtual mediante su propia API; el HTTP Binding integrado de openHAB puede consultar el endpoint JSON directamente, sin binding personalizado.
La API JSON y los topics MQTT de Pylon-Monitor son abiertos, están documentados y son independientes de plataforma desde el primer día — conéctelos a lo que ya use.
Pedir ahora — 59 € Compra única, 59 € en total — sin IVA, sin suscripción.