API Endpoints
Latest Measurement
The "Latest Measurement" endpoint returns the last measurement value recorded by the Cloud. The measured value can have an age of 15-60 minutes, depending on the transmission interval you have parameterised. The identifiers of the return values depend on the device type. For example the identifiers of type "Air purifier" are different from those of type "Negative pressure unit".API Request
https://api.deconta-connect.com/device/latest/measurement
? login = LOGIN_ID
? client = CLIENT_ID
? token = API_TOKEN
? article = DEVICE_ARTICLE
? serial = DEVICE_SERIAL
Example API Response Greendec/Smartdec NPU Series
{
"success": true,
"date": "2021-04-09 08:33:24",
"data": {
"negativePressure": "0",
"filterPressure": "0",
"volumeFlow": "0",
"power": "0",
"current": "0",
"filterLoad": "0",
"powerControl": "0",
"negativePressureControlMinDay": "0",
"negativePressureControlMinNight": "0",
"negativePressureControlMax": "0",
"volumeFlowControl": "0"
}
}
Negative Pressure Unit API Response Format
The maximum values depend on the type of device. These can be found in your operating instructions. For example, a G100 SRE Connect has a significantly lower maximum volume flow than a G700 SRE Connect.
{
"success": true,
"date": "2021-04-09 08:33:24",
"data": {
"negativePressure": "0",
"filterPressure": "0",
"volumeFlow": "0",
"power": "0",
"current": "0",
"filterLoad": "0",
"powerControl": "0",
"negativePressureControlMinDay": "0",
"negativePressureControlMinNight": "0",
"negativePressureControlMax": "0",
"volumeFlowControl": "0"
}
}
Air Purifier API Response Format
The maximum values depend on the type of device. These can be found in your operating instructions. For example, a R151 Connect has a significantly lower maximum volume flow than a R401 Connect.
{
"success": true,
"date": "2021-04-09 08:33:24",
"data": {
"power": "0",
"current": "0",
"volumeFlow": "0",
"pollution": "0",
"filterPressure": "0",
"voc": "0",
"temp": "0",
"humidity": "0",
"presence": "0",
}
}
Air Sampler API Response Format
The maximum values depend on the type of device. These can be found in your operating instructions.
{
"success": true,
"date": "2021-04-09 08:33:24",
"data": {
}
}
Latest Error
The "Latest Error" endpoint returns the last error recorded by the Cloud. Our Latest Error Endpoint returns a 2 x 1 byte array. Using this array, we can display up to 16 possible pending error messages at the same time.API Request
https://api.deconta-connect.com/device/latest/error
? login = LOGIN_ID
? client = CLIENT_ID
? token = API_TOKEN
? article = DEVICE_ARTICLE
? serial = DEVICE_SERIAL
Example API Response
{
success": true,
"date": "2020-11-18 19:59:59",
"data": [
[ // Error Byte 0
"1", // Bit 7
"1", // Bit 6
"0", // Bit 5
"0", // Bit 4
"0", // Bit 3
"0", // Bit 2
"0", // Bit 1
"0" // Bit 0
],
[ // Error Byte 1
"0", // Bit 7
"0", // Bit 6
"0", // Bit 5
"0", // Bit 4
"0", // Bit 3
"0", // Bit 2
"0", // Bit 1
"0" // Bit 0
]
]
}
Negative Pressure Unit API Response
| Byte | Bit | Description |
|---|---|---|
| 0 | 0 | The configured volume flow value could not be reached |
| 0 | 1 | Filter pressure maximum value exceeded |
| 0 | 2 | The setpoint of the negative pressure control cannot be reached |
| 0 | 3 | Dust sensor (low) detected |
| 0 | 4 | Dust sensor (high) detected |
| 0 | 5 | Dust sensor (stop) |
| 0 | 6 | Unused |
| 0 | 7 | Unused |
| 1 | 0 | Unused |
| 1 | 1 | Unused |
| 1 | 2 | Unused |
| 1 | 3 | Unused |
| 1 | 4 | Unused |
| 1 | 5 | Unused |
| 1 | 6 | Unused |
| 1 | 7 | Unused |
Air Purifier API Response
| Byte | Bit | Description |
|---|---|---|
| 0 | 0 | Unused |
| 0 | 1 | Unused |
| 0 | 2 | Unused |
| 0 | 3 | Unused |
| 0 | 4 | Unused |
| 0 | 5 | Unused |
| 0 | 6 | Unused |
| 0 | 7 | Unused |
| 1 | 0 | Unused |
| 1 | 1 | Unused |
| 1 | 2 | Unused |
| 1 | 3 | Unused |
| 1 | 4 | Unused |
| 1 | 5 | Unused |
| 1 | 6 | Unused |
| 1 | 7 | Unused |
Air Sampler API Response
| Byte | Bit | Description |
|---|---|---|
| 0 | 0 | Unused |
| 0 | 1 | Unused |
| 0 | 2 | Unused |
| 0 | 3 | Unused |
| 0 | 4 | Unused |
| 0 | 5 | Unused |
| 0 | 6 | Unused |
| 0 | 7 | Unused |
| 1 | 0 | Unused |
| 1 | 1 | Unused |
| 1 | 2 | Unused |
| 1 | 3 | Unused |
| 1 | 4 | Unused |
| 1 | 5 | Unused |
| 1 | 6 | Unused |
| 1 | 7 | Unused |
Telealarm API Response
The error messages depend on whether you have already configured custom error messages for your device
| Byte | Bit | Description |
|---|---|---|
| 0 | 0 | Unused |
| 0 | 1 | Unused |
| 0 | 2 | Unused |
| 0 | 3 | Unused |
| 0 | 4 | Unused |
| 0 | 5 | Unused |
| 0 | 6 | Unused |
| 0 | 7 | Unused |
| 1 | 0 | Power outage |
| 1 | 1 | Alarm channel 1 |
| 1 | 2 | Alarm channel 2 |
| 1 | 3 | Alarm channel 3 |
| 1 | 4 | Alarm channel 4 |
| 1 | 5 | Unused |
| 1 | 6 | Unused |
| 1 | 7 | Unused |
Control Device
With the "Control Device" Endpoint, you can change the operating parameters of your device The identifiers of the API Endpoint differ depending on the type of device. You will find an explanation of the identifiers listed in a table below the example. In order to make it as easy and quick as possible to get started, we have made sure to use the same identifiers that you already know from the "Latest Measurement" endpoint. Certain parameters differ in their maximum value, for example a device of type S200 has a lower maximum volume flow than a device of type S300. The maximum values of your device can be found in the technical documentationAPI Request
https://api.deconta-connect.com/device/control ? login = LOGIN_ID ? client = CLIENT_ID ? token = API_TOKEN ? article = DEVICE_ARTICLE ? serial = DEVICE_SERIAL ? type = CONTROL_IDENTIFIER ? value = CONTROL_VALUE
Example API Request
https://api.deconta-connect.com/device/control ? login = demo@deconta-connect.com ? client = 123456789 ? token = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ? article = 0754 ? serial = 0123 ? type = powerControl ? value = 50
API Response
{
"success": true,
"date": "2021-04-09 08:33:24",
}
Negative Pressure Unit API Identifiers
Certain parameters differ in their maximum value, for example a device of type S200 has a lower maximum flow than a device of type S300. The maximum values of your device can be found in the technical documentation
| Identifier | Description |
|---|---|
| powerControl | Power Value 0% - 100% |
| negativePressureControlMinDay | Negative Pressure (Day Mode) 0Pa - 100Pa |
| negativePressureControlMinNight | Negative Pressure (Night Mode) 0Pa - 100Pa |
| negativePressureControlMax | Negative Pressure Maximum 0Pa - 100Pa |
| volumeFlowControl | Volume Flow (Depends on device type) |