This request delivers all alarms of one or more customers.
alert
GET
-
This parameter is optional. Default is json.
format=json|xml
This parameter is required. You may access data of one or more customers by comma delimited string of customers slcIDs. No comma at the beginning or end of this string.
customer=104,105
You may restrict the recordset by start time and/oder end time. Timeconstraints are local time.
from=2017-11-25T08:00:35 to=2017-11-25T15:00:35
You may restrict the recordset by comma delimited list of alertState(s). No comma at the beginning or end of this string.
state=3,6
You may restrict the recordset by comma delimited list of alertType(s). No comma at the beginning or end of this string.
types=4097,4353
| Entity | Type | Nullable | Description |
|---|---|---|---|
| customer[] | array (mainEntity) | no |
| Entity | Type | Nullable | Description |
|---|---|---|---|
| customer_id | int | no | slcID of customer |
| alert[] | array (alert) | no | alerts |
| Entity | Type | Nullable | Description |
|---|---|---|---|
| id | int | no | slcID of alarm |
| type | int (alertType) | no | alert type |
| state | int (alertState) | no | alert state |
| event_date | datetime | no | date and time of alert |
| gateway_id | int | yes | slcID of gateway (origin of alert, if available) |
| device_id | int | yes | slcID of device (it is a device specific alert, if available) |
| job_id | int | yes | slcID of job (if available) |
| Value | Description |
|---|---|
| -9 | External alert |
| -4 | Tilt Alert |
| -3 | Smart Meter Alert |
| -2 | SLC RC-Switch Offline |
| 0 | Unbekannter Fehler |
| 4097 | Gateway-Fehler: Nicht erreichbar |
| 4353 | Gateway-Fehler: Hardware failure |
| 4354 | Gateway: Betriebsystemfehler |
| 4608 | Gateway: Unbekannte Warnung |
| 4609 | Gateway: Sensor Warnung |
| 4610 | Gateway: Log-Warnung |
| 4611 | Gateway: Betriebsystemwarnung |
| 8193 | |
| 8194 | Geräte-Fehler: Hardware-Fehler |
| 8448 | |
| 8449 | |
| 8450 | |
| 8451 | |
| 8452 | |
| 8453 | |
| 8454 | |
| 8704 | Geräte-Warnung: Sensoren |
| 8705 | Geräte-Warnung: Übertemperatur Steuerung |
| 8706 | Geräte-Warnung: Übertemperatur LED |
| 12289 | Job: Jobausführung schlug fehl |
| 12290 | Die Geräte-ID wird bereits bei einem anderen Kunden gebraucht. |
| Value | Description |
|---|---|
| 1 | Noch nicht versendet |
| 3 | Alarm versendet |
| 4 | Bestätigt |
| 5 | In Bearbeitung |
| 6 | Behoben |
<?xml version="1.0" encoding="UTF-8" ?> <slControl> <customer> <customer_id>2</customer_id> <alert> <id>21</id> <type>8452</type> <state>3</state> <event_date>2016-10-13 15:30:44</event_date> <gateway_id>79</gateway_id> </alert> <alert> <id>23</id> <type>12289</type> <state>6</state> <event_date>2018-04-22 11:21:13</event_date> <job_id>17</job_id> </alert> <alert> <id>72</id> <type>-9</type> <state>1</state> <event_date>2018-04-15 15:21:33</event_date> </alert> </customer> <customer> <customer_id>4</customer_id> <alert> <id>31</id> <type>12289</type> <state>6</state> <event_date>2017-05-14 18:45:37</event_date> <job_id>45</job_id> </alert> <alert> <id>39</id> <type>12289</type> <state>6</state> <event_date>2017-05-14 18:45:37</event_date> <job_id>72</job_id> </alert> </customer> </slControl>
{
"customer": {
"customer_id": "4",
"alert": [{
"id": "31",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "45"
}, {
"id": "39",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "72"
}, {
"id": "40",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "83"
}, {
"id": "41",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "84"
}, {
"id": "42",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "85"
}, {
"id": "43",
"type": "12289",
"state": "6",
"event_date": "2017-05-14 18:45:37",
"job_id": "92"
}, {
"id": "67",
"type": "12289",
"state": "6",
"event_date": "2018-11-08 14:37:36",
"job_id": "33"
}]
}
}