Refresh HVAC data for user
curl --request GET \
--url https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"isOnline": true,
"id": "6eb5497d-c6bb-4290-84ef-4409fe9501f1",
"userId": "896f9d5a-b618-48a2-98ae-957059bf1bc9",
"staticData": {
"lastUpdated": "2023-11-07T05:31:56Z",
"vendor": "VIESSMANN",
"model": "Vitotronic 200",
"capableModes": [
"HEAT"
],
"name": "Viessmann Vitotronic 200",
"type": "AC",
"room": "Living room"
},
"lastUpdated": "2023-11-07T05:31:56Z",
"powerState": {
"lastUpdated": "2023-11-07T05:31:56Z",
"powerConsumption": 123
},
"locationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"climateState": {
"mode": "HEAT",
"lastUpdated": "2023-11-07T05:31:56Z",
"temperatureTargets": [
{
"mode": "HEAT",
"temperature": 18.1
}
],
"isActive": true,
"temperatureCurrent": 20.3,
"temperatureOutside": 12.1
}
}HVAC for user
Refresh HVAC data for user
Updates HVAC with newest data from vendor system for the user.
GET
/
v1.0.0
/
users
/
{userId}
/
hvacs
/
{hvacId}
/
refresh
Refresh HVAC data for user
curl --request GET \
--url https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.energy-hub.io/v1.0.0/users/{userId}/hvacs/{hvacId}/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"isOnline": true,
"id": "6eb5497d-c6bb-4290-84ef-4409fe9501f1",
"userId": "896f9d5a-b618-48a2-98ae-957059bf1bc9",
"staticData": {
"lastUpdated": "2023-11-07T05:31:56Z",
"vendor": "VIESSMANN",
"model": "Vitotronic 200",
"capableModes": [
"HEAT"
],
"name": "Viessmann Vitotronic 200",
"type": "AC",
"room": "Living room"
},
"lastUpdated": "2023-11-07T05:31:56Z",
"powerState": {
"lastUpdated": "2023-11-07T05:31:56Z",
"powerConsumption": 123
},
"locationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"climateState": {
"mode": "HEAT",
"lastUpdated": "2023-11-07T05:31:56Z",
"temperatureTargets": [
{
"mode": "HEAT",
"temperature": 18.1
}
],
"isActive": true,
"temperatureCurrent": 20.3,
"temperatureOutside": 12.1
}
}Authorizations
API key used for authorization and authentication.
Response
Successful operation
Object of HVAC response.
Indicates if the HVAC is reachable trough the vendor system.
Example:
true
The ID of the HVAC.
Example:
"6eb5497d-c6bb-4290-84ef-4409fe9501f1"
The ID of the user.
Example:
"896f9d5a-b618-48a2-98ae-957059bf1bc9"
Object of static data of a HVAC.
Show child attributes
Show child attributes
The timestamp of the last update of any variable of the HVAC.
Object of power state of HVAC device.
Show child attributes
Show child attributes
The location ID of the HVAC.
Object of climate state of HVAC device.
Show child attributes
Show child attributes

