💬 Chatta con noi su WhatsApp
Integrazione tecnica

API WiNet

Questa pagina descrive le API Remote e le API Locali del sistema WiNet. Sono pensate per sviluppatori, integratori domotici e installatori che vogliono integrare il controllo della stufa con sistemi esterni.

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.

API Key WiNet

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

0Off
1-2Attesa fiamma / Waiting flame
3Accensione / Ignition
4Lavoro / Work
5Stand-by
6Pulizia finale / Final cleaning
7Pulizia braciere / Brazier cleaning
8Allarme / Alarm
9Memoria 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/status
Spegnimento:
http://[ip dispositivo]/api/status/0
Accensione:
http://[ip dispositivo]/api/status/1

Temperatura aria

http://[ip dispositivo]/api/temperature/air
Impostazione:
http://[ip dispositivo]/api/temperature/air/24
Range consigliato stufe aria: 5°C – 40°C

Temperatura acqua

http://[ip dispositivo]/api/temperature/water
Impostazione:
http://[ip dispositivo]/api/temperature/water/65
Range: 40°C – 80°C Solo per stufe IDRO.

Potenza

http://[ip dispositivo]/api/power
Impostazione:
http://[ip dispositivo]/api/power/5
Range: 1 – 5 alcuni modelli supportano fino a **9 potenze**.