Webhooks

Bei Webhooks handelt es sich um HTTP Trigger, die bei einem Event geschickt werden. Mit diesem Event können Daten versendet werden, die es ermöglichen Fremd-APIs anzusteuern. Der Aufbau der Daten kann frei bestimmt werden. Die veränderlichen Nutzdaten werden mithilfe von Variablen eingefügt. Diese werden zum Zeitpunkt der Auslösung ersetzt.

Alle hier dargestellten API- und SNMP Beispiele beziehen sich auf die zum Zeitpunkt der Erstellung des Artikes aktuellen Versionen der jeweiligen Produkte. Diese unterliegen fortlaufender Entwicklung.
Die ReST API sowie die SNMP Schnittstellen werden der Dokumentation entsprechend ausgeliefert. KENTIX setzt bei Verwendung dieser Schnittstellen grundsätzliche Kenntnisse dieser Technologien beim Anwender voraus.
Um Sie optimal bei der Umsetzung ihrer individuellen Projektanforderungen zu unterstützen, bieten wir passende Support-Pakete an. Ein entsprechendes Zeitkontingent können sie einfach im Kentix Shop buchen.

Mögliche Variablen

Variable NameDescription
Alarm
“$ACTIVE_ALARM_SENSOR_NAME$“Alarm Sensor Name
“$ACTIVE_ALARM_MEASUREMENT_VALUE$“Alarm Sensor Measurement Value:
(Value Unit)
“$ACTIVE_ALARM_ALARM_VALUE$“Alarm Sensor Alarm State:
0: OK
1: Alarm
2: Alarm quittable
3: Warning
4: Prealarm
5: Warning quittable
User
„$USER_ID$“User ID
„$USER_NAME$“User Name
„$USER_FULLNAME$“User Full Name
„$USER_MAIL$“User Mail
„$USER_RFID_UID$“User RFID UID
„$USER_RFID_DATA$“User RFID DATA
„$USER_PIN$“User PIN
„$USER_UUID$“User UUID
„$USER_PHONE_NUMBER$“User Phone number
Access
„$ACCESS_STATE$“Access Request Result:
0: Ok
1: Invalid remote request
2: Device not found
3: RFID unknown
4: PIN unknown
5: 2-factor auth. failed
6: User not found
7: No time permission
8: No door permission
9: General errror
Device
„$DEVICE_ID$“Device ID
„$DEVICE_NAME$“Device Name
„$DEVICE_ADDRESS$Device Address
„$DEVICE_MAC$“Device MAC
„$DEVICE_SERIAL$“Device Serial Number
„$DEVICE_UUID$Device UUID
„$DEVICE_TYPE$“Device Type
Sensors
For all sensor variables:_VALUE“ = (Value Unit)
_ALARM„= Alarm Sensor Alarm State:
0: OK
1: Alarm
2: Alarm quittable
3: Warning
4: Prealarm
5: Warning quittable
…[number]$“ = Number of Input: [1-9]
„$INPUT_VALUE[number]$“Input Measurement Value of Sensor
„$INPUT_ALARM[number]$“Input Alarm State of Sensor
„$DI_NAME[number]$“Digital Input Name
„$BATTERY_ALARM$“Battery Alarm State
„$CO2_VALUE$“CO2 Measurement Value
„$CO2_ALARM$“CO2 Alarm State
„$DEWPOINT_VALUE$“Dewpoint Measurement Value
„$DEWPOINT_ALARM$“Dewpoint Alarm State
„$HUMIDITY_VALUE$“Humidity Measurement Value
„$HUMIDITY_ALARM$“Humidity Alarm State
„$LATENCY_VALUE$“Latency Measurement Value
„$LATENCY_ALARM$“Latency Alarm State
„$MOTION_VALUE$“Motion Measurement Value
„$MOTION_ALARM$“Motion Alarm State
„$REED_VALUE$“Reed Measurement Value
„$REED_ALARM$“Reed Alarm State
„$SABOTAGE_VALUE$“Sabotage Measurement Value
„$SABOTAGE_ALARM$“Sabotage Alarm State
„$CONNECTION_VALUE$“Connection Measurement Value
„$CONNECTION_ALARM$“Connection Alarm State
„$EXTPOWER_VALUE$“External Power Measuremet Value
„$EXTPOWER_ALARM$“External Power Alarm State
„$TEMPERATURE_VALUE$“Temperature Measurement Value
„$TEMPERATURE_ALARM$“Temperature Alarm State
„$TILT_VALUE$“Tilt Measurement Value
„$TILT_ALARM$“Tilt Alarm State
„$VIBRATION_VALUE$“Vibration Measurement Value
„$VIBRATION_ALARM$“Vibration Alarm State
„$SNMP_VALUE$“SNMP Measurement Value
„$SNMP_ALARM$“SNMP Alarm State
„$AIR_QUALITY_VALUE$“Air Quality Measurement Value
„$AIR_QUALITY_ALARM$“Air Quality Alarm State
„$AIR_QUALITY_FIRE_VALUE$“Air Quality Fire Measurement Value
„$AIR_QUALITY_FIRE_ALARM$“Air Quality Fire Alarm State
„$FIRE_HEAT_VALUE$“Fire Heat Measurement Value
„$FIRE_HEAT_ALARM$“Fire Heat Alarm State
„$FIRE_TI_VALUE$“Fire TI Measurement Value
„$FIRE_TI_ALARM$“Fire TI Alarm State
„$FIRE_CO_VALUE$Fire CO Measurement Value
„$FIRE_CO_ALARM$“Fire CO Alarm State
Power
For all power variables:_VALUE“ = (Value Unit)
…_ALARM„= Alarm State: 0: OK
1: Alarm
2: Alarm quittable
3: Warning
4: Prealarm
5: Warning quittable
…[number]$“ = Number of Phase [1-3]
phase
„$PHASE_NAME[number]$“Phase Name
„$PHASE_NUMBER[number]$“Phase Number
„$VOLTAGE[number]$“Phase Voltage
„$VOLTAGE_ALARM[number]$“Phase Voltage Alarm State
„$CURRENT[number]$“Phase Current
„$CURRENT_ALARM[number]$“Phase Current Alarm State
„$POWER_ACTIVE[number]$“Active Power
„$POWER_ACTIVE_ALARM[number]$“Active Power Alarm State
„$POWER_REACTIVE[number]$“Reactive Power
„$POWER_REACTIVE_ALARM[number]$“Reactive Power Alarm State
„$POWER_APPARENT[number]$“Apparent Power
„$POWER_APPARENT_ALARM[number]$“Apparent Power Alarm State
„$POWER_FACTOR[number]$“Power Factor
„$FREQUENCY[number]$“Frequency
„$FREQUENCY_ALARM[number]$“Frequency Alarm State
„$CONSUMPTION[number]$“Power Consuption Value
„$FUSE_ALARM[number]$“Fuse Alarm State
„$FUSE_VALUE[number]$“Fuse Value
device
„$RCM_AC$“AC RCM
„$RCM_AC_ALARM$“AC RCM Alarm State
„$RCM_DC$“DC RCM
„$RCM_DC_ALARM$“DC Alarm State
„$SYNCHRONICITY_VALUE$“Power Synchronicity
„$SYNCHRONICITY_ALARM$“Power Synchronicity Alarm State
Groups
„$GROUP_ID$“Group ID
„$GROUP_NAME$“Group Name
„$GROUP_STATE$“Group Arming State:
0: Disarmed
1: Armed

„$GROUP_UUID$“
Group UUID
$GROUP_ARMED_PREALARM_COUNT$““Group „Armed Active“ Prealarm Count
„$GROUP_ARMED_ALARM_COUNT$“Group „Armed Active“ Alarm Count
„$GROUP_ARMED_QUITABLE_ALARM_COUNT$“Group „Armed Active“ quittable Alarms Count
„$GROUP_ARMED_WARNING_COUNT$“Group „Armed Active“ Warning Count
„$GROUP_ALWAYS_ALARM_COUNT$“Group „Always Active“ Alarm Count
„$GROUP_ALWAYS_QUITABLE_ALARM_COUNT$“Group „Always Active“ quittable Alarm Count
„$GROUP_ALWAYS_WARNING_COUNT$“Group „Always Active“ Warning Count
„$GROUP_ALWAYS_QUITABLE_WARNING_COUNT$“Group „Always Active“ quittable Alarm Count
„$GROUP_FIRE_ALARM_COUNT$“Group „Fire“ Alarm Count
„$GROUP_FIRE_QUITABLE_ALARM_COUNT$“Group „Fire“ quittable Alarm Count
„$GROUP_FIRE_WARNING_COUNT$“Group „Fire“ Warning Count
„$GROUP_FIRE_QUITABLE_WARNING_COUNT$“Group „Fire“ quittable Warning Count
„$GROUP_SABOTAGE_ALARM_COUNT$“Group „Sabotage“ Alarm Count
„$GROUP_SABOTAGE_QUITABLE_ALARM_COUNT$“Group „Sabotage“ quittable Alarm Count
„$GROUP_SABOTAGE_WARNING_COUNT$“Group „Sabotage“ Warning Count
„$GROUP_SABOTAGE_QUITABLE_WARNING_COUNT$“Group „Sabotage“ quittable Warning Count
„$GROUP_SYSTEM_ALARM_COUNT$“Group „System“ Alarm Count
„$GROUP_SYSTEM_QUITABLE_ALARM_COUNT$“Group „System“ quittable Alarm Count
„$GROUP_SYSTEM_WARNING_COUNT$“Group „System“ Warning Count
„$GROUP_SYSTEM_QUITABLE_WARNING_COUNT$“Group „System“ quittable Warning Count
System
„$SYSTEM_TIME$“System Time YYYY-MM-DD HH:MM:SS
„$SYSTEM_UNIXTIME$“System Time in Unixtime (UTC)
„$SYSTEM_TEMP_UNIT$“System Temperature Unit (F/C)
„$SYSTEM_NAME$“System Name
„$SYSTEM_ADDRESS$“System Address
„$SYSTEM_MAC$“Sytem MAC
„$SYSTEM_HOSTNAME$“System Hostname
„$SYSTEM_SERIAL$“System Serial Number
Possible Variables for Webhooks (Version 8.3.4)

Beispiele

Einfache Meldung

{
    "alarm-sensor-name:" "$ACTIVE_ALARM_SENSOR_NAME$",
    "alarm-sensor-value:" "$ACTIVE_ALARM_MEASUREMENT_VALUE$",
    "active-alarm-assignment:" "$ACTIVE_ALARM_ALARM_VALUE$"

}

Access

{
    "time:" "$SYSTEM_TIME$",
    "user:" "$USER_NAME$",
    "rfid:" "$USER_RFID_UID$",
    "pin:" "$USER_PIN$",
    "state:" "$ACCESS_STATE$",
    "door:" "$DEVICE_NAME$"

}

MultiSensor

{
    "time:" "$SYSTEM_TIME$",
    "device-name:" "$DEVICE_NAME$",
    "temperature-unit:" "$SYSTEM_TEMP_UNIT$"
    "temperature:" "$TEMPERATURE_VALUE$",
    "humidity:" "$HUMIDITY_VALUE$",
    "humidity-alarm:" "$HUMIDITY_ALARM$",
    "dewpoint:" "$DEWPOINT_VALUE$",
    "dewpoint-alarm:" "$DEWPOINT_ALARM$",
    "fire-co:" "$FIRE_CO_VALUE$",
    "fire-alarm:" "$FIRE_CO_ALARM$",
    "fire-air-quality:" "$AIR-QUALITY-FIRE-VALUE$"
    "fire-air-quality-alarm:" "$AIR_QUALITY_FIRE_ALARM$"
    "intrusion:" "$MOTION_VALUE$",
    "intrusion-alarm:" "$MOTION_ALARM$",
    "vibration:" "$VIBRATION_VALUE$",
    "vibration-alarm:" "$VIBRATION_ALARM$",
    "input1-name:" "$DI_NAME[1]$",
    "input1_value:" "$INPUT_VALUE[1]$",
    "input1-alarm:" "$INPUT_ALARM[1]$",
    "input2-name:" "$DI_NAME[2]$",
    "input2_value:" "$INPUT_VALUE[2]$",
    "input2-alarm:" "$INPUT_ALARM[2]$",
    "connection:" "$CONNECTION_VALUE$",
    "connection-alarm:" "$CONNECTION_ALARM$",
    "external power:" "$EXTPOWER_VALUE$",
    "extpower-alarm:" "$EXTPOWER_ALARM$"
}

PowerManager

{
    "time:" "$SYSTEMTIME$",
    "system-name": "SYSTEM-NAME$",
    "address": "$SYSTEM_ADDRESS$",
    "rcm:"
    {
        "ac:"
        {
            "value:" "$RCM_AC$",
            "alarm:" "$RCM_AC_ALARM$"
        },
        "dc":
        {
            "value:" "$RCM_DC$",
            "alarm:" "$RCM_DC_ALARM$"
        }
     {
       "syncronicity:"
       {
            "value:" "$SYNCHRONICITY_VALUE$",
            "alarm:" "$SYNCHRONICITY_ALARM$"
       }
     }
    },
    "power_failure:" "$POWER_FAILURE_ALARM$",
    "phases:"
    [
        {
            "name": "$PHASE_NAME[1]$",
            "number": "$PHASE_NUMBER[1]$",
            "voltage":
            {
                "value": "$VOLTAGE[1]$",
                "alarm": "$VOLTAGE_ALARM[1]$"
            },
            "current":
            {
                "value": "$CURRENT[1]$",
                "alarm": "$CURRENT_ALARM[1]$"
            },
            "power":
            {
                "active":
                {
                    "value": "$POWER_ACTIVE[1]$",
                    "alarm": "$POWER_ACTIVE_ALARM[1]$"
                },
                "reactive":
                {
                    "value": "$POWER_REACTIVE[1]$",
                    "alarm": "$POWER_REACTIVE_ALARM[1]$"
                },
                "apparent":
                {
                    "value": "$POWER_APPARENT[1]$",
                    "alarm": "$POWER_APPARENT_ALARM[1]$"
                },
                "factor":
                {
                    "value": "$POWER_FACTOR[1]$"
                }
            },
            "frequency":
            {
                "value": "$FREQUENCY[1]$",
                "alarm": "$FREQUENCY_ALARM[1]$"
            },
            "consumption":
            {
                "value": "$CONSUMPTION[1]$"
            },
            "fuse":
            {
                "alarm": "$FUSE_ALARM[1]$"
            }
        },
        {
            "name": "$PHASE_NAME[2]$",
            "number": "$PHASE_NUMBER[2]$",
            "voltage":
            {
                "value": "$VOLTAGE[2]$",
                "alarm": "$VOLTAGE_ALARM[2]$"
            },
            "current":
            {
                "value": "$CURRENT[2]$",
                "alarm": "$CURRENT_ALARM[2]$"
            },
            "power":
            {
                "active":
                {
                    "value": "$POWER_ACTIVE[2]$",
                    "alarm": "$POWER_ACTIVE_ALARM[2]$"
                },
                "reactive":
                {
                    "value": "$POWER_REACTIVE[2]$",
                    "alarm": "$POWER_REACTIVE_ALARM[2]$"
                },
                "apparent":
                {
                    "value": "$POWER_APPARENT[2]$",
                    "alarm": "$POWER_APPARENT_ALARM[2]$"
                },
                "factor":
                {
                    "value": "$POWER_FACTOR[2]$"
                }
            },
            "frequency":
            {
                "value": "$FREQUENCY[2]$",
                "alarm": "$FREQUENCY_ALARM[2]$"
            },
            "consumption":
            {
                "value": "$CONSUMPTION[2]$"
            },
            "fuse":
            {
                "alarm": "$FUSE_ALARM[2]$"
            }
        },
        {
            "name": "$PHASE_NAME[3]$",
            "number": "$PHASE_NUMBER[3]$",
            "voltage":
            {
                "value": "$VOLTAGE[3]$",
                "alarm": "$VOLTAGE_ALARM[3]$"
            },
            "current":
            {
                "value": "$CURRENT[3]$",
                "alarm": "$CURRENT_ALARM[3]$"
            },
            "power":
            {
                "active":
                {
                    "value": "$POWER_ACTIVE[3]$",
                    "alarm": "$POWER_ACTIVE_ALARM[3]$"
                },
                "reactive":
                {
                    "value": "$POWER_REACTIVE[3]$",
                    "alarm": "$POWER_REACTIVE_ALARM[3]$"
                },
                "apparent":
                {
                    "value": "$POWER_APPARENT[3]$",
                    "alarm": "$POWER_APPARENT_ALARM[3]$"
                },
                "factor":
                {
                    "value": "$POWER_FACTOR[3]$"
                }
            },
            "frequency":
            {
                "value": "$FREQUENCY[3]$",
                "alarm": "$FREQUENCY_ALARM[3]$"
            },
            "consumption":
            {
                "value": "$CONSUMPTION[3]$"
            },
            "fuse":
            {
                "alarm": "$FUSE_ALARM[3]$"
            }
        }
    ]
}
War dieser Artikel hilfreich?

Verwandte Artikel