API REMOTE
Le API Remote permettono di controllare la stufa tramite internet e sono ideali per:
- piattaforme cloud
- portali di supervisione
- integrazioni con sistemi domotici
- applicazioni personalizzate
1) Descrizione del webservice
Il webservice descritto nei metodi dei punti successivi permette l’interfacciamento della propria stufa con dispositivi per l’home automation.
The web service described in the methods of the following points allows the interfacing of your stove with devices for home automation.
2) Chiave APIKEY
La chiave API si trova nella pagina dell’applicazione cloud che mostra l’elenco dei dispositivi, cliccando sul nome della stufa.
The API key can be found on the cloud web application page that shows the list of devices, by clicking on the stove name.
3) Leggere lo stato della stufa
URL
https://ws.cloudwinet.it/WiNetStove.svc/json/GetStatus/[your apikey]
Response
{
"Error":0,
"ErrorDescription":"",
"Status":0,
"StatusDescription":"OFF"
}
Possibili stati della stufa
| 0 | Off |
| 1-2 | Attesa fiamma / Waiting flame |
| 3 | Accensione / Ignition |
| 4 | Lavoro / Work |
| 5 | Stand-by |
| 6 | Pulizia finale / Final cleaning |
| 7 | Pulizia braciere / Brazier cleaning |
| 8 | Allarme / Alarm |
| 9 | Memoria allarme / Alarm memory |
4) Accensione stufa
https://ws.cloudwinet.it/WiNetStove.svc/json/Ignit/[apikey]
Response
{
"Error":0,
"ErrorDescription":"",
"Success":true/false
}
5) Spegnimento stufa
https://ws.cloudwinet.it/WiNetStove.svc/json/Shutdown/[apikey]
{
"Error":0,
"ErrorDescription":"",
"Success":true/false
}
6) Impostazione potenza
https://ws.cloudwinet.it/WiNetStove.svc/json/SetPower/[apikey];[1-5]
{
"Error":0,
"ErrorDescription":"",
"Success":true/false
}
7) Impostazione temperatura
https://ws.cloudwinet.it/WiNetStove.svc/json/SetTemperature/[apikey];[5-40]
{
"Error":0,
"ErrorDescription":"",
"Success":true/false
}
API LOCALI
Le API locali permettono di interrogare il dispositivo WiNet direttamente dalla rete locale, anche senza connessione internet.
Sono molto utili per integrazioni con sistemi domotici come Home Assistant.
Identificazione dispositivo
http://[ip dispositivo]/api/id
{
"id":"WiNET Gen. Stove",
"mac":"XXXXXXXXXXXX",
"apSsid":"wifi access point",
"apWpaPwd":"wifi access point password",
"staSsid":"wifi network"
}
Stato globale
http://[ip dispositivo]/api/global
{
"status":0,
"description":"Off",
"gasflue":30,
"rpmExtractor":0,
"air":18.5,
"setAir":20.0,
"water":18,
"setWater":20,
"power":1
}
Accensione / Spegnimento
http://[ip dispositivo]/api/statusSpegnimento:
http://[ip dispositivo]/api/status/0Accensione:
http://[ip dispositivo]/api/status/1
Temperatura aria
http://[ip dispositivo]/api/temperature/airImpostazione:
http://[ip dispositivo]/api/temperature/air/24Range consigliato stufe aria: 5°C – 40°C
Temperatura acqua
http://[ip dispositivo]/api/temperature/waterImpostazione:
http://[ip dispositivo]/api/temperature/water/65Range: 40°C – 80°C Solo per stufe IDRO.
Potenza
http://[ip dispositivo]/api/powerImpostazione:
http://[ip dispositivo]/api/power/5Range: 1 – 5 alcuni modelli supportano fino a **9 potenze**.