API locali WiNet | WiFi-Stufe.com

A cosa servono

Perché usare le API locali

Le API locali sono utili quando vuoi integrare WiNet in un sistema domotico che comunica direttamente con i dispositivi presenti nella rete interna dell’abitazione o dell’impianto.

Interrogare lo stato della stufa dalla rete locale.
Leggere temperature, potenza e stato operativo.
Inviare comandi di accensione e spegnimento.
Impostare temperatura aria, temperatura acqua e potenza.
Integrare WiNet con Home Assistant o altri sistemi domotici.

Nota: per usare le API locali, il dispositivo WiNet e il sistema che invia i comandi devono trovarsi nella stessa rete locale, oppure in una rete configurata correttamente per consentire la comunicazione.

Requisiti

Cosa ti serve

Modulo WiNet installato e collegato alla stufa.
Modulo WiNet connesso alla rete WiFi locale.
Indirizzo IP locale del dispositivo WiNet.
Browser, Home Assistant o altro software in grado di fare richieste HTTP.
Conoscenza base della rete locale e degli indirizzi IP.

Negli esempi di questa pagina l’indirizzo del dispositivo viene indicato come [ip dispositivo]. Dovrai sostituirlo con l’indirizzo IP reale del tuo modulo WiNet, ad esempio 192.168.1.50.

Esempio base

Formato degli indirizzi locali

Gli endpoint locali seguono questo formato:

http://[ip dispositivo]/api/...

Esempio con un IP reale:

http://192.168.1.50/api/global

Aprendo questo indirizzo dal browser, se il modulo è raggiungibile, dovresti ricevere una risposta in formato JSON con i dati disponibili.

Endpoint

Identificazione dispositivo

Questo endpoint permette di leggere alcune informazioni identificative del modulo WiNet, come modello, MAC address e rete WiFi configurata.

http://[ip dispositivo]/api/id

Risposta di esempio:

{ "id":"WiNET Gen. Stove", "mac":"XXXXXXXXXXXX", "apSsid":"wifi access point", "apWpaPwd":"wifi access point password", "staSsid":"wifi network" }

Attenzione: questo endpoint può mostrare informazioni tecniche del dispositivo. Usalo solo all’interno di reti sicure e non esporre il modulo direttamente su internet senza adeguate protezioni.

Stato stufa

Stato globale della stufa

Questo endpoint restituisce lo stato principale della stufa e alcuni valori utili per la supervisione domotica.

http://[ip dispositivo]/api/global

Risposta di esempio:

{ "status":0, "description":"Off", "gasflue":30, "rpmExtractor":0, "air":18.5, "setAir":20.0, "water":18, "setWater":20, "power":1 }

status: stato numerico della stufa.
description: descrizione dello stato.
gasflue: temperatura fumi.
rpmExtractor: giri estrattore fumi.
air: temperatura ambiente rilevata.
setAir: temperatura aria impostata.
water: temperatura acqua, se disponibile.
setWater: temperatura acqua impostata, se disponibile.
power: potenza impostata.

Accensione e spegnimento

Gestione dello stato

L’endpoint seguente permette di leggere o modificare lo stato della stufa.

Verifica stato:

http://[ip dispositivo]/api/status

Spegnimento:

http://[ip dispositivo]/api/status/0

Accensione:

http://[ip dispositivo]/api/status/1

Importante: usa sempre i comandi di accensione e spegnimento nel rispetto delle istruzioni del produttore della stufa e delle condizioni di sicurezza dell’impianto.

Potenza

Lettura e impostazione potenza

Questo endpoint permette di leggere la potenza impostata e, dove supportato, modificarla.

Lettura potenza:

http://[ip dispositivo]/api/power

Impostazione potenza:

http://[ip dispositivo]/api/power/5

Il range standard è 1 – 5. Alcuni modelli di stufa possono supportare fino a 9 potenze.

Temperatura aria

Lettura e impostazione temperatura aria

Questo endpoint permette di leggere la temperatura aria impostata e modificarla.

Lettura temperatura aria:

http://[ip dispositivo]/api/temperature/air

Impostazione temperatura aria:

http://[ip dispositivo]/api/temperature/air/24

Range consigliato per stufe aria: 5°C – 40°C.

Temperatura acqua

Lettura e impostazione temperatura acqua

Questo endpoint è dedicato alle stufe idro, dove è disponibile la gestione della temperatura acqua.

Lettura temperatura acqua:

http://[ip dispositivo]/api/temperature/water

Impostazione temperatura acqua:

http://[ip dispositivo]/api/temperature/water/65

Range indicativo: 40°C – 80°C. Funzione disponibile solo per stufe idro compatibili.

Home Assistant

Uso delle API locali con Home Assistant

Le API locali sono particolarmente utili per integrare WiNet con Home Assistant, perché permettono al sistema domotico di comunicare direttamente con il modulo presente nella rete locale.

In questo modo puoi creare dashboard, sensori, comandi e automazioni personalizzate in base alla configurazione della tua casa.

Visualizzazione dello stato della stufa.
Automazioni basate sulla temperatura ambiente.
Comandi di accensione e spegnimento da dashboard.
Regole legate a presenza, orari, scenari e altri sensori.

Vai alla guida Home Assistant Vedi anche API remote

Sicurezza

Consigli importanti

Non esporre direttamente le API locali su internet senza protezioni.
Usa le API locali solo su reti affidabili.
Verifica sempre il comportamento della stufa dopo ogni comando.
Evita automazioni rischiose o non presidiate se l’impianto non è adatto.
Rispetta sempre le istruzioni del produttore della stufa.

Nota tecnica: questa pagina è pensata per utenti evoluti, tecnici e integratori. Se non hai esperienza con reti locali, indirizzi IP o sistemi domotici, ti consigliamo di richiedere supporto prima di procedere.

Supporto tecnico

Serve aiuto con le API locali?

Se vuoi integrare WiNet con Home Assistant, software domotici o applicazioni personalizzate, possiamo aiutarti a verificare la configurazione del modulo, l’indirizzo IP locale e gli endpoint più adatti al tuo caso.

Quando ci contatti, indica il modello della stufa, il numero seriale del modulo WiNet e, se possibile, il tipo di sistema domotico che vuoi utilizzare.

Scrivici su WhatsApp Vai ai contatti Torna alle guide