get https://{url}/v1/devices//space
Use the hub_url received in the registration response as your base URL.
This API requires the device to authenticate, see Device Authentication.
Get the latest device space information from the server.
After a device is updated, it should call the Update Device API with space_version set to the current version. This notifies the server that the device has processed the update and is in sync with the server.
Return Data
{
"location": {
"coordinates": {
"lat": 51.165691,
"lng": 10.451526
},
"utc_offset": 60,
"name": "Germany"
},
"temperature_units": "celsius",
"maintenance": false,
"name": "Interactive Class",
"local_time": "2022-03-17T10:55:28+01:00",
"device_id": "fbe103c8-...",
}
Key | Subkey | Subkey | Type | Description | Model API Version |
---|---|---|---|---|---|
location | object | NULL if not set | 1.0.1+ | ||
coordinates | object | 1.0.1+ | |||
lat | float | Latitude | 1.0.1+ | ||
long | float | Longitude | 1.0.1+ | ||
utc_offset | number | Offset in minutes from UTC | 1.0.1+ | ||
name | string | Location's name | 1.0.1+ | ||
1.0.1+ | |||||
temperature_units | string | Temperature units for the space | 1.0.1+ | ||
maintenance | boolean | Indicates whether the space is in maintenance mode | 1.0.1+ | ||
name | string | Space name | 1.0.1+ | ||
local_time | date | Local time of the space | 1.0.1+ | ||
device_id | string | Device ID | 1.0.7+ |