Kentix GmbH
API docs by Redocly

Kentix SmartAPI (8.4.4)

Download OpenAPI specification:Download

Kentix GmbH: info@kentix.com URL: https://kentix.com/ License: Kentix GmbH

Important Remarks

Before you start, please read the following information carefully

  • Foreknowledge

    • This documentation assumes knowledge of ReST concepts.
    • In order to use the KentixONE ReST API, you need knowledge of the corresponding programming concepts and their methods.

  • Support

    • We ask for your understanding that we cannot offer free support for questions regarding program implementation or project integration within the scope of our technical support.
    • For this purpose, we offer bookable support packages for optimal support in your project and integration questions.

  • Developer Notes

    • Please be sure to always include the Accept: application/json header in your requests. Not doing so will result in being redirected to the login page.
    • For automated integrations see our YAML OpenAPI schema.

  • Authentication

    • The Kentix SmartAPI uses Bearer Token authentication
    • A user may find his personal API Bearer Token in his user profile or as JSON key 'api_token' when requesting a users detail.

Access-Events

Access-Event List

Get Access-Events

Get a list of Access-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Access-Event Export

Access-Event Export

Export Access-Events

Export all Access-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Access-Event Images

Access-Event Images

Get Access-Events

Get a list of Access-Events.

Authorizations:
bearer
path Parameters
access_event
required
string

Access-Event ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Access Settings

Functions to request and update the general access settings.

Get the access settings

Request the access settings.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "external_evaluation": 1,
  • "pinlength": 1,
  • "memorydepth": 1,
  • "mode": 1,
  • "bus_protocol": "v1"
}

Update the access settings.

Updates the access settings. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

abcdef...

external_evaluation
boolean

If true, the manager will not evaluate access permissions. Instead, upon bookings a webhook is sent and DoorLocks can only be remote-opened.

pinlength
string [ 4 .. 10 ]

Sets the length of the user pin. Must be between 4 and 10.

memorydepth
string [ 0 .. 720 ]

Sets the number of days during which all user-related data (bookings, images, etc) is stored. 0 = Unlimited, must be between 0 and 720.

mode
integer

Sets the RFID security mode. 0=Off, 1=Kentix Token, 2=Custom security token.

bus_protocol
string
Enum: "v1" "v2"

Select what version of wallreaders are used with this device. V2 devices are labeled with 'V2' next to their respective devicetype. V1 devices do not have a version label.

Responses

Request samples

Content type
application/json
{
  • "external_evaluation": 1,
  • "pinlength": 1,
  • "memorydepth": 1,
  • "mode": 1,
  • "bus_protocol": "v1"
}

Response samples

Content type
application/json
[
  • {
    }
]

AccessManager List

Functions to manage AccessManagers.

Get Accessmanagers

Get a list of all AccessManagers.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

AccessManager Names

Function to get a list of all the names of the AccessManagers.

Get names of Accessmanagers

Get the names of all AccessManagers.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

AccessManager Details

Functions to get or modify a specific AccessManager via the id.

Get Accessmanager informations

Requests all detail of a specific AccessManager via the id.

Authorizations:
bearer
path Parameters
accessmanager_id
required
string

ID of the Accessmanager to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "type": 105,
  • "is_active": true,
  • "name": "AccessManager",
  • "mac_adress": "70:82:0e:10:81:3d",
  • "address": "192.168.100.224",
  • "doorlocks": [
    ],
  • "ios": [
    ],
  • "relais_action_arm": "none",
  • "ext_arm_doorlocks": [
    ],
  • "external": {
    },
  • "group_id": 89,
  • "rack_id": 50,
  • "webhooks": [
    ]
}

Update the configuration of an AccessManager via the ID.

Updates the configuration of a specific AccessManager. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
path Parameters
accessmanager_id
required
string

ID of the Accessmanager to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

AccessManager configuration to be updated.

id
integer

ID of the AccessManager.

type
integer

Devicetype of the AccessManager.

is_active
boolean

True if the alarm evaluation and communication for this device is activated

name
string

Name of the AccessManager.

mac_adress
string

MAC address of the AccessManager

address
string

IP or DNS address of the AccessManager.

Array of objects
Array of objects
relais_action_arm
string
Enum: "none" "channel1" "channel2" "backchannel1" "backchannel2" "backchannel_inevitability"

Configures if an external system should be switched on bookings.

ext_arm_doorlocks
Array of integers

List of all DoorLock IDs, which have been configured to switch an external alarmsystem.

object
group_id
integer

Id of the group the AccessManager beolongs to

rack_id
integer

Id of the rack the AccessManager belongs to

webhooks
Array of integers

Integer Array of the webhooks

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "type": 105,
  • "is_active": true,
  • "name": "AccessManager",
  • "mac_adress": "70:82:0e:10:81:3d",
  • "address": "192.168.100.224",
  • "doorlocks": [
    ],
  • "ios": [
    ],
  • "relais_action_arm": "none",
  • "ext_arm_doorlocks": [
    ],
  • "external": {
    },
  • "group_id": 89,
  • "rack_id": 50,
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Alarm-Events

Alarm-Event List

Get Alarm-Events

Get a list of Alarm-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {},
  • "meta": {}
}

Alarm-Event Export

Alarm-Event Export

Export Alarm-Events

Export all Alarm-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Alarm-Event Images

Alarm-Event Images

Get Alarm-Events

Get a list of Alarm-Events.

Authorizations:
bearer
path Parameters
alarm_event
required
string

Alarm-Event ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Alarmgroups List

Get alarmgroups

Get all alarmgroups.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Add alarmgroup

Add a new alarmgroup.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Describes the name of the alarmgroup.

group_id
integer

Indicates the parent alarm group. Must be an Id of an existing group.

in_stealthmode
boolean

Describes if the internal status LED of all devices in this alarmgroup should be activated.

signaling_group
integer or null

Describes the range in which a signaling is triggered, if an alarm occurs within this alarmgroup. Must be an Id of an parent group.

maintenance
string
Enum: "active" "inactive"

Describes if the alarmgroup is in maintenance mode.

maintenance_start
string or null <ISO 8601>

Describes when the alarmgroup automatically switches to maintenance mode.

maintenance_stop
string or null <ISO 8601>

Describes until when the alarmgroup remains in maintenance mode.

inherit_notification
boolean

Describes if the notification settings should be inherited from the parent group.

is_alarmrepetition_active
boolean

Describes if active alarms should be repeated by it's configured interval. Acknowledgment of the alarm stops the repetition.

alarmrepetition_interval
integer [ 1 .. 999 ]

Describes how alarms are sent to all users configured for alarms, depending on the configured time and repetitions.

alarmrepetition_count
integer [ 0 .. 100 ]

Describes the number of alarm repetitions with the interval of the configured time.

send_quitable_notifications
boolean

Describes if a notification should be sent as soon as an alarm is quitable.

limit_notifications_always
boolean

Limits the always-active notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_always_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of always-active alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_always is true.

notification_count_always_warning
boolean or null

Notify in case of always-active warnings. Only required if limit_notifications_always is true.

limit_notifications_armed
boolean

Limits the armed-active notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_armed_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of armed-active alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_armed is true.

notification_count_armed_warning
boolean or null

Notify in case of armed-active warnings. Only required if limit_notifications_armed is true.

limit_notifications_fire
boolean

Limits the fire notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_fire_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of fire alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_fire is true.

notification_count_fire_warning
boolean or null

Notify in case of fire warnings. Only required if limit_notifications_fire is true.

limit_notifications_sabotage
boolean

Limits the sabotage notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_sabotage_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of sabotage alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_sabotage is true.

notification_count_sabotage_warning
boolean or null

Notify in case of sabotage warnings. Only required if limit_notifications_sabotage is true.

limit_notifications_system
boolean

Limits the system notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_system_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of system alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_system is true.

notification_count_system_warning
boolean or null

Notify in case of system warnings. Only required if limit_notifications_system is true.

inherit_arm
boolean

Describes if the arm settings should be inherited from the parent group.

arm_delay
integer
Enum: 0 10 30 60 120 180 240 300 600 1200 1800 3600

Describes the arm delay. Only required if inherit_arm is false.

buzzer_arm_duration
integer
Enum: 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the arm buzzer duration. Only required if inherit_arm is false.

can_alwaysarm
boolean

Describes if the status of external contacts should be ignored during arming. This is useful if e.g. a magnetic door contact must be opened during the arming phase.

inherit_autoquit
boolean

Describes if the autoquit settings should be inherited from the parent group.

can_autoquit_always_alarm
boolean

Describes if always-active alarms should be automatically acknowledged after the given interval. Only required if inherit_autoquit is false.

can_autoquit_armed_alarm
boolean

Describes if armed-active alarms should be automatically acknowledged after the given interval. Only required if inherit_autoquit is false.

can_autoquit_fire_alarm
boolean

Describes if fire alarms should be automatically acknowledged after the given interval. Only required if inherit_autoquit is false.

can_autoquit_sabotage_alarm
boolean

Describes if sabotage alarms should be automatically acknowledged after the given interval. Only required if inherit_autoquit is false.

can_autoquit_system_notification_alarm
boolean

Describes if system alarms should be automatically acknowledged after the given interval. Only required if inherit_autoquit is false.

autoquit_duration
integer
Enum: 0 30 60 180 600 1800

Describes the time after which automatic quitting is executed. Only required if inherit_autoquit is false.

inherit_alarm
boolean

Describes if the alarm settings should be inherited from the parent group.

has_prealarm
boolean

Describes if the Prealarm is en-/disabled.

buzzer_alwaysalarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for always-active alarms (-1 stands for permanent). Only required if inherit_alarm is false.

buzzer_armedalarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for armed-active alarms (-1 stands for permanent). Only required if inherit_alarm is false.

buzzer_firealarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for fire alarms (-1 stands for permanent). Only required if inherit_alarm is false.

buzzer_sabotagealarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for sabotage alarms (-1 stands for permanent). Only required if inherit_alarm is false.

inherit_sabotagesignal
boolean

Describes if the signaling sabotage settings should be inherited from the parent group.

sabotage_powerdevice_duration
integer
Enum: 300 600 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a plugged device should wait, until it fires a tampering alarm. Only required if inherit_sabotagesignal is false.

sabotage_batterydevice_duration
integer
Enum: 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a battery device should wait, until it fires a tampering alarm. Only required if inherit_sabotagesignal is false.

sabotage_service_duration
integer
Enum: 600 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a service should wait, until it fires a tampering alarm. Only required if inherit_sabotagesignal is false.

event_id
integer or null

Describes the event that should be used. Must be an Id of an existing event.

Array of objects

Describes the webhooks that should be fired when an event happens

assigned_doorlock
integer or null

The ID of the doorlock directly assigned to the alarmgroup.

Responses

Request samples

Content type
application/json
{
  • "name": "Kentix HQ",
  • "group_id": 1,
  • "in_stealthmode": false,
  • "signaling_group": 1,
  • "maintenance": "inactive",
  • "maintenance_start": "2023-02-17T01:00:00.000Z",
  • "maintenance_stop": "2023-02-17T23:59:00.000Z",
  • "inherit_notification": false,
  • "is_alarmrepetition_active": false,
  • "alarmrepetition_interval": 1,
  • "alarmrepetition_count": 0,
  • "send_quitable_notifications": false,
  • "limit_notifications_always": true,
  • "notification_count_always_alarm": 1,
  • "notification_count_always_warning": false,
  • "limit_notifications_armed": true,
  • "notification_count_armed_alarm": 1,
  • "notification_count_armed_warning": false,
  • "limit_notifications_fire": false,
  • "notification_count_fire_alarm": 0,
  • "notification_count_fire_warning": false,
  • "limit_notifications_sabotage": false,
  • "notification_count_sabotage_alarm": 0,
  • "notification_count_sabotage_warning": false,
  • "limit_notifications_system": false,
  • "notification_count_system_alarm": 0,
  • "notification_count_system_warning": false,
  • "inherit_arm": false,
  • "arm_delay": 0,
  • "buzzer_arm_duration": 0,
  • "can_alwaysarm": false,
  • "inherit_autoquit": false,
  • "can_autoquit_always_alarm": false,
  • "can_autoquit_armed_alarm": false,
  • "can_autoquit_fire_alarm": false,
  • "can_autoquit_sabotage_alarm": false,
  • "can_autoquit_system_notification_alarm": false,
  • "autoquit_duration": 0,
  • "inherit_alarm": false,
  • "has_prealarm": false,
  • "buzzer_alwaysalarm_duration": 0,
  • "buzzer_armedalarm_duration": 0,
  • "buzzer_firealarm_duration": 0,
  • "buzzer_sabotagealarm_duration": 0,
  • "inherit_sabotagesignal": false,
  • "sabotage_powerdevice_duration": 300,
  • "sabotage_batterydevice_duration": 900,
  • "sabotage_service_duration": 600,
  • "event_id": 0,
  • "webhooks": [
    ],
  • "assigned_doorlock": 3
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "created_at": "2023-01-07T18:08:44.000000Z",
  • "updated_at": "2023-01-07T18:08:44.000000Z",
  • "name": "Kentix HQ",
  • "group_id": 1,
  • "sort_index": 1,
  • "in_stealthmode": false,
  • "signaling_group": 1,
  • "maintenance": "inactive",
  • "maintenance_start": "2023-02-17T01:00:00.000Z",
  • "maintenance_stop": "2023-02-17T23:59:00.000Z",
  • "inherit_notification": false,
  • "is_alarmrepetition_active": false,
  • "alarmrepetition_interval": 1,
  • "alarmrepetition_count": 0,
  • "send_quitable_notifications": false,
  • "limit_notifications_always": true,
  • "notification_count_always_alarm": 1,
  • "notification_count_always_warning": false,
  • "limit_notifications_armed": true,
  • "notification_count_armed_alarm": 1,
  • "notification_count_armed_warning": false,
  • "limit_notifications_fire": false,
  • "notification_count_fire_alarm": 0,
  • "notification_count_fire_warning": false,
  • "limit_notifications_sabotage": false,
  • "notification_count_sabotage_alarm": 0,
  • "notification_count_sabotage_warning": false,
  • "limit_notifications_system": false,
  • "notification_count_system_alarm": 0,
  • "notification_count_system_warning": false,
  • "inherit_arm": false,
  • "arm_delay": 0,
  • "buzzer_arm_duration": 0,
  • "can_alwaysarm": false,
  • "inherit_autoquit": false,
  • "can_autoquit_always_alarm": false,
  • "can_autoquit_armed_alarm": false,
  • "can_autoquit_fire_alarm": false,
  • "can_autoquit_sabotage_alarm": false,
  • "can_autoquit_system_notification_alarm": false,
  • "autoquit_duration": 0,
  • "inherit_alarm": false,
  • "has_prealarm": false,
  • "buzzer_alwaysalarm_duration": 0,
  • "buzzer_armedalarm_duration": 0,
  • "buzzer_firealarm_duration": 0,
  • "buzzer_sabotagealarm_duration": 0,
  • "inherit_sabotagesignal": false,
  • "sabotage_powerdevice_duration": 300,
  • "sabotage_batterydevice_duration": 900,
  • "sabotage_service_duration": 600,
  • "event_id": 0,
  • "webhooks": [
    ],
  • "assigned_doorlock": 3
}

Alarmgroup Details

Get alarmgroup

Get a specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "created_at": "2023-01-07T18:08:44.000000Z",
  • "updated_at": "2023-01-07T18:08:44.000000Z",
  • "name": "Kentix HQ",
  • "group_id": 1,
  • "sort_index": 1,
  • "in_stealthmode": false,
  • "signaling_group": 1,
  • "maintenance": "inactive",
  • "maintenance_start": "2023-02-17T01:00:00.000Z",
  • "maintenance_stop": "2023-02-17T23:59:00.000Z",
  • "inherit_notification": false,
  • "is_alarmrepetition_active": false,
  • "alarmrepetition_interval": 1,
  • "alarmrepetition_count": 0,
  • "send_quitable_notifications": false,
  • "limit_notifications_always": true,
  • "notification_count_always_alarm": 1,
  • "notification_count_always_warning": false,
  • "limit_notifications_armed": true,
  • "notification_count_armed_alarm": 1,
  • "notification_count_armed_warning": false,
  • "limit_notifications_fire": false,
  • "notification_count_fire_alarm": 0,
  • "notification_count_fire_warning": false,
  • "limit_notifications_sabotage": false,
  • "notification_count_sabotage_alarm": 0,
  • "notification_count_sabotage_warning": false,
  • "limit_notifications_system": false,
  • "notification_count_system_alarm": 0,
  • "notification_count_system_warning": false,
  • "inherit_arm": false,
  • "arm_delay": 0,
  • "buzzer_arm_duration": 0,
  • "can_alwaysarm": false,
  • "inherit_autoquit": false,
  • "can_autoquit_always_alarm": false,
  • "can_autoquit_armed_alarm": false,
  • "can_autoquit_fire_alarm": false,
  • "can_autoquit_sabotage_alarm": false,
  • "can_autoquit_system_notification_alarm": false,
  • "autoquit_duration": 0,
  • "inherit_alarm": false,
  • "has_prealarm": false,
  • "buzzer_alwaysalarm_duration": 0,
  • "buzzer_armedalarm_duration": 0,
  • "buzzer_firealarm_duration": 0,
  • "buzzer_sabotagealarm_duration": 0,
  • "inherit_sabotagesignal": false,
  • "sabotage_powerdevice_duration": 300,
  • "sabotage_batterydevice_duration": 900,
  • "sabotage_service_duration": 600,
  • "event_id": 0,
  • "webhooks": [
    ],
  • "assigned_doorlock": 3
}

Update alarmgroup

Update a specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
One of
sort_index
integer

Describes the sorting order.

in_stealthmode
boolean

Describes if the internal status LED of all devices in this alarmgroup should be activated.

maintenance
string
Enum: "active" "inactive"

Describes if the alarmgroup is in maintenance mode.

maintenance_start
string or null <ISO 8601>

Describes when the alarmgroup automatically switches to maintenance mode.

maintenance_stop
string or null <ISO 8601>

Describes until when the alarmgroup remains in maintenance mode.

is_alarmrepetition_active
boolean

Describes if active alarms should be repeated by it's configured interval. Acknowledgment of the alarm stops the repetition.

alarmrepetition_interval
integer [ 1 .. 999 ]

Describes how alarms are sent to all users configured for alarms, depending on the configured time and repetitions.

alarmrepetition_count
integer [ 0 .. 100 ]

Describes the number of alarm repetitions with the interval of the configured time.

send_quitable_notifications
boolean

Describes if a notification should be sent as soon as an alarm is quitable.

limit_notifications_always
boolean

Limits the always-active notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_always_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of always-active alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_always is true.

notification_count_always_warning
boolean or null

Notify in case of always-active warnings. Only required if limit_notifications_always is true.

limit_notifications_armed
boolean

Limits the armed-active notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_armed_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of armed-active alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_armed is true.

notification_count_armed_warning
boolean or null

Notify in case of armed-active warnings. Only required if limit_notifications_armed is true.

limit_notifications_fire
boolean

Limits the fire notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_fire_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of fire alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_fire is true.

notification_count_fire_warning
boolean or null

Notify in case of fire warnings. Only required if limit_notifications_fire is true.

limit_notifications_sabotage
boolean

Limits the sabotage notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_sabotage_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of sabotage alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_sabotage is true.

notification_count_sabotage_warning
boolean or null

Notify in case of sabotage warnings. Only required if limit_notifications_sabotage is true.

limit_notifications_system
boolean

Limits the system notifications per hour. Manual acknowledgement resets the counter, repeated alarms do not count.

notification_count_system_alarm
integer or null [ 0 .. 1000 ]

Describes the limit of system alarm notifications. 0 deactivates the notifications. Only required if limit_notifications_system is true.

notification_count_system_warning
boolean or null

Notify in case of system warnings. Only required if limit_notifications_system is true.

arm_delay
integer
Enum: 0 10 30 60 120 180 240 300 600 1200 1800 3600

Describes the arm delay.

buzzer_arm_duration
integer
Enum: 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the arm buzzer duration.

can_alwaysarm
boolean

Describes if the status of external contacts should be ignored during arming. This is useful if e.g. a magnetic door contact must be opened during the arming phase.

can_autoquit_always_alarm
boolean

Describes if always-active alarms should be automatically acknowledged after the given interval.

can_autoquit_armed_alarm
boolean

Describes if armed-active alarms should be automatically acknowledged after the given interval.

can_autoquit_fire_alarm
boolean

Describes if fire alarms should be automatically acknowledged after the given interval.

can_autoquit_sabotage_alarm
boolean

Describes if sabotage alarms should be automatically acknowledged after the given interval.

can_autoquit_system_notification_alarm
boolean

Describes if system alarms should be automatically acknowledged after the given interval.

autoquit_duration
integer
Enum: 0 30 60 180 600 1800

Describes the time after which automatic quitting is executed.

has_prealarm
boolean

Describes if the Prealarm is en-/disabled.

buzzer_alwaysalarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for always-active alarms (-1 stands for permanent).

buzzer_armedalarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for armed-active alarms (-1 stands for permanent).

buzzer_firealarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for fire alarms (-1 stands for permanent).

buzzer_sabotagealarm_duration
integer
Enum: -1 0 1 3 10 30 60 120 180 300 600 1200 1800 3600

Describes the buzzer length for sabotage alarms (-1 stands for permanent).

sabotage_powerdevice_duration
integer
Enum: 300 600 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a plugged device should wait, until it fires a tampering alarm.

sabotage_batterydevice_duration
integer
Enum: 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a battery device should wait, until it fires a tampering alarm.

sabotage_service_duration
integer
Enum: 600 900 1200 1500 1800 2100 2400 2700 3000 3300 3600

Describes how long a service should wait, until it fires a tampering alarm.

event_id
integer or null

Describes the event that should be used. Must be an Id of an existing event.

Array of objects

Describes the webhooks that should be fired when an event happens

assigned_doorlock
integer or null

The ID of the doorlock directly assigned to the alarmgroup.

Responses

Request samples

Content type
application/json
Example
{
  • "sort_index": 1,
  • "in_stealthmode": false,
  • "maintenance": "inactive",
  • "maintenance_start": "2023-02-17T01:00:00.000Z",
  • "maintenance_stop": "2023-02-17T23:59:00.000Z",
  • "is_alarmrepetition_active": false,
  • "alarmrepetition_interval": 1,
  • "alarmrepetition_count": 0,
  • "send_quitable_notifications": false,
  • "limit_notifications_always": true,
  • "notification_count_always_alarm": 1,
  • "notification_count_always_warning": false,
  • "limit_notifications_armed": true,
  • "notification_count_armed_alarm": 1,
  • "notification_count_armed_warning": false,
  • "limit_notifications_fire": false,
  • "notification_count_fire_alarm": 0,
  • "notification_count_fire_warning": false,
  • "limit_notifications_sabotage": false,
  • "notification_count_sabotage_alarm": 0,
  • "notification_count_sabotage_warning": false,
  • "limit_notifications_system": false,
  • "notification_count_system_alarm": 0,
  • "notification_count_system_warning": false,
  • "arm_delay": 0,
  • "buzzer_arm_duration": 0,
  • "can_alwaysarm": false,
  • "can_autoquit_always_alarm": false,
  • "can_autoquit_armed_alarm": false,
  • "can_autoquit_fire_alarm": false,
  • "can_autoquit_sabotage_alarm": false,
  • "can_autoquit_system_notification_alarm": false,
  • "autoquit_duration": 0,
  • "has_prealarm": false,
  • "buzzer_alwaysalarm_duration": 0,
  • "buzzer_armedalarm_duration": 0,
  • "buzzer_firealarm_duration": 0,
  • "buzzer_sabotagealarm_duration": 0,
  • "sabotage_powerdevice_duration": 300,
  • "sabotage_batterydevice_duration": 900,
  • "sabotage_service_duration": 600,
  • "event_id": 0,
  • "webhooks": [
    ],
  • "assigned_doorlock": 3
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "created_at": "2023-01-07T18:08:44.000000Z",
  • "updated_at": "2023-01-07T18:08:44.000000Z",
  • "name": "Kentix HQ",
  • "group_id": 1,
  • "sort_index": 1,
  • "in_stealthmode": false,
  • "signaling_group": 1,
  • "maintenance": "inactive",
  • "maintenance_start": "2023-02-17T01:00:00.000Z",
  • "maintenance_stop": "2023-02-17T23:59:00.000Z",
  • "inherit_notification": false,
  • "is_alarmrepetition_active": false,
  • "alarmrepetition_interval": 1,
  • "alarmrepetition_count": 0,
  • "send_quitable_notifications": false,
  • "limit_notifications_always": true,
  • "notification_count_always_alarm": 1,
  • "notification_count_always_warning": false,
  • "limit_notifications_armed": true,
  • "notification_count_armed_alarm": 1,
  • "notification_count_armed_warning": false,
  • "limit_notifications_fire": false,
  • "notification_count_fire_alarm": 0,
  • "notification_count_fire_warning": false,
  • "limit_notifications_sabotage": false,
  • "notification_count_sabotage_alarm": 0,
  • "notification_count_sabotage_warning": false,
  • "limit_notifications_system": false,
  • "notification_count_system_alarm": 0,
  • "notification_count_system_warning": false,
  • "inherit_arm": false,
  • "arm_delay": 0,
  • "buzzer_arm_duration": 0,
  • "can_alwaysarm": false,
  • "inherit_autoquit": false,
  • "can_autoquit_always_alarm": false,
  • "can_autoquit_armed_alarm": false,
  • "can_autoquit_fire_alarm": false,
  • "can_autoquit_sabotage_alarm": false,
  • "can_autoquit_system_notification_alarm": false,
  • "autoquit_duration": 0,
  • "inherit_alarm": false,
  • "has_prealarm": false,
  • "buzzer_alwaysalarm_duration": 0,
  • "buzzer_armedalarm_duration": 0,
  • "buzzer_firealarm_duration": 0,
  • "buzzer_sabotagealarm_duration": 0,
  • "inherit_sabotagesignal": false,
  • "sabotage_powerdevice_duration": 300,
  • "sabotage_batterydevice_duration": 900,
  • "sabotage_service_duration": 600,
  • "event_id": 0,
  • "webhooks": [
    ],
  • "assigned_doorlock": 3
}

Delete alarmgroup

Delete specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup to be queried

Responses

Add Device

Add specified device to alarmgroup.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup (must be a leaf node) to be queried

device
required
string

ID of the device to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Add IO

Add specified IO to alarmgroup.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup (must be a leaf node, except for digital output) to be queried

io
required
string

ID of the device to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Get OID-List

Get OID-List for sepcified alarmgroup.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgroup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "group": {
    }
}

Arm Alarmgroup

Arm alarmgroup

Arm a specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgoup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Disarm Alarmgroup

Disarm alarmgroup

Disarm a specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgoup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Quit Alarmgroup

Quit alarmgroup

Quit a specific alarmgroup via its ID.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

ID of the alarmgoup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Alarmgroup Names

Get alarmgroup names

Requests all alarmgroups which the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Alarmmanager List

Alarmmanagers

Get AlarmManagers

Get a list of AlarmManagers.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Alarmmanager Names

Alarmmanager Names

Get AlarmManager names

Get a list of AlarmManager names.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Alarmmanager Details

Alarmmanager configuration

Get Details

Get the details of the given AlarmManager.

Authorizations:
bearer
path Parameters
alarmmanager_id
required
string

AlarmManager ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "AlarmManager",
  • "description": "Alarmmanager main hall",
  • "type": 101,
  • "type_name": "Alarmmanager",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of given AlarmManager.

Authorizations:
bearer
path Parameters
alarmmanager_id
required
string

AlarmManager ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

device_id
integer

the ID of the device this device is assigned to

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

description
string

The description of the device

type
integer

The type of the device

type_name
string

The name of the type

address
string

The address of the device

alarmdelay
integer

The amount of seconds an alarm will be delayed

object
object
object
group_id
integer

The ID of the group the device is assigned to

rack_id
integer

The ID of the rack the device is assigned to

object
object
Array of objects

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "AlarmManager",
  • "description": "Alarmmanager main hall",
  • "type": 101,
  • "type_name": "Alarmmanager",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "AlarmManager",
  • "description": "Alarmmanager main hall",
  • "type": 101,
  • "type_name": "Alarmmanager",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Backup Configuration

Backup Configuration

Get backup status

Requests the status of the last backup and the possible storage locations.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "latest": {
    },
  • "available_destinations": {
    }
}

Create backup

Creates a new backup.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
password
string or null <= 250

Password for encryption of the backup.

destination
string

Destination for the backup.

Responses

Request samples

Content type
application/json
{
  • "password": "password",
  • "destination": "download"
}

Response samples

Content type
application/json
{
  • "latest": {
    },
  • "available_destinations": {
    }
}

Download backup

Downloads the latest backup and then deletes the backup.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Restore backup

Restores a provided backup.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: multipart/form-data
backup
required
string <base64>

Backup as binary file

password
string

Password of the encrypted backup.

Responses

Response samples

Content type
application/json
{
  • "status": "ok",
  • "address": "192.188.100.224",
  • "type": "The backup file is not compatible with this device."
}

Automatic Backup Configuration

Automatic Backup Configuration

Get automatic backup configuration

Requests the status of the automatic backup configuration.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "time": "00:00",
  • "type": 2,
  • "delete_after_days": 1,
  • "address": "0.0.0.0",
  • "share": "SMB Rack",
  • "path": "/home/kentix/backup",
  • "username": "root",
  • "password": "password",
  • "send_notification": true
}

Update automatic backup configuration

Updates the automatic backup configuration.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
is_active
boolean

Describes it automatic backup is en-/disabled.

time
string <HH:mm>

Describes at which time the backup should be created.

type
integer [ 1 .. 2 ]

Describes the selected Storage Drive [1 => SD-Card; 2 => Network Drive (SMB)]

delete_after_days
integer [ 0 .. 7 ]

Describes how long Backups should be stored.

0 (never) is only for type 2 allowed.

address
string or null

Describes the IP-Address of the Network Drive.

Needed when type is 2.

share
string or null

Describes the share name.

Needed when type is 2.

path
string or null

Describes the storage path.

username
string or null

Describes the username for the SMB share.

password
string or null

Describes the password for the SMB share.

send_notification
boolean

Describes if a notification should be send after a backup was created.

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "time": "00:00",
  • "type": 2,
  • "delete_after_days": 1,
  • "address": "0.0.0.0",
  • "share": "SMB Rack",
  • "path": "/home/kentix/backup",
  • "username": "root",
  • "password": "password",
  • "send_notification": true
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "time": "00:00",
  • "type": 2,
  • "delete_after_days": 1,
  • "address": "0.0.0.0",
  • "share": "SMB Rack",
  • "path": "/home/kentix/backup",
  • "username": "root",
  • "password": "password",
  • "send_notification": true
}

Check SMB configuration

Checks if the current Network Drive (SMB) configuration is correct / works.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "has_response": true,
  • "response_code": 0
}

Update SMB configuration

Updates the current Network Drive (SMB) configuration.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
address
string

Describes the IP-Address of the Network Drive.

share
string

Describes the share name.

Needed when type is 2.

path
string or null

Describes the storage path.

username
string or null

Describes the username for the SMB share.

password
string or null

Describes the password for the SMB share.

Responses

Request samples

Content type
application/json
{
  • "address": "0.0.0.0",
  • "share": "SMB Rack",
  • "path": "/home/kentix/backup",
  • "username": "root",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "has_response": true,
  • "response_code": 0
}

Camera List

Functions to modify and update network cameras.

Get cameras

Requests a list of all camera names the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Camera Names

Get the names of all cameras.

Get camera names

Requests a list of all camera names the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Camera Details

Functions to get and modify a specific camera.

Get camera informations

Requests all detail of a specific camera via the id.

Authorizations:
bearer
path Parameters
camera_id
required
string

ID of the camera to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "is_active": true,
  • "name": "Camera",
  • "camera_location": "outdoor",
  • "protocol": "http",
  • "address": "192.168.100.2",
  • "profile": "ipro",
  • "capture_path": "/image/picture.png",
  • "stream_path": "/video/",
  • "username": "user",
  • "passsword": "password",
  • "append_mail": false,
  • "alarm_assignments": [
    ],
  • "group_id": 1,
  • "rack_id": 1,
  • "webhooks": [
    ]
}

Update a camera via the ID

Updates the configuration of a specific camera. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
path Parameters
camera_id
required
string

ID of the camera to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Camera configuration to be updated.

name
string

Name of the camera.

camera_location
string

Mounting area of the camera, can be: indoor, outdoor. Outdoor cameras use a prebuffer to capture persons before the actual booking.

protocol
string

Communication protocol, can be: http, https.

address
string

Network address of the camera.

profile
string

Manufacturer of the camera.

capture_path
string

Path/URL to get the images of the camera.

username
string

Username for logging in on the camera, if needed.

passsword
string

Password for logging in on the camera, if needed.

append_mail
boolean

If true the system appends an image to the alarm e-mail

image_count
integer

Sets the number of images to be stored for every booking.

prebuffer_count
integer

Sets the number of images BEFORE the actual booking to be stored, outdoor cameras only. Counts to the actual image_count, e.g. if 10 images should be stored and prebuffer is 4, only 6 additional imaged AFTER the booking are stored.

Responses

Request samples

Content type
application/json
{
  • "name": "Camera",
  • "camera_location": "outdoor",
  • "protocol": "http",
  • "address": "192.168.100.2",
  • "profile": "ipro",
  • "capture_path": "/image/picture.png",
  • "username": "user",
  • "passsword": "password",
  • "append_mail": false,
  • "image_count": 10,
  • "prebuffer_count": 4
}

Response samples

Content type
application/json
[
  • {
    }
]

Camera Live Image

Get the live image of a specific camera.

Get camera live image

Requests the live image of a specific camera via the id.

Authorizations:
bearer
path Parameters
camera_id
required
string

ID of the camera to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
"string"

KentixONE information

Get KentixONE information

Requests status information of KentixONE connection state.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "cloud2Status": true,
  • "devicecount_exceeded": false,
  • "hasCloud2Token": true,
  • "hasK360Token": true,
  • "has_licence": true,
  • "has_licence_cloud2": true,
  • "is_active": false,
  • "is_active_cloud2": true,
  • "k360Token": "0000-0000-0000-0000-0000-0000-0000-0000",
  • "licence_valid": true,
  • "licence_type": 2,
  • "status": false
}

Dashboard Data

Data deemed useful for a dashboard

Get dashboard data

Get the dashboard data.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "status": {
    },
  • "events": [
    ],
  • "active_alarms": [
    ],
  • "key_figures": [
    ]
}

Date & Time Configuration

Date and Time configuration

Get date and time configuration

Requests the date and time configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update date and time configuration

Updates the date and time configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
auto
boolean

If true, the device will automatically set the date and time using the configured NTP server.

ntp1
string

The first NTP server to use for automatic date and time configuration.

ntp2
string

The second NTP server to use for automatic date and time configuration.

timezone
string

The timezone to use for automatic date and time configuration.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "auto": true,
  • "ntp1": "0.pool.ntp.org",
  • "ntp2": "1.pool.ntp.org",
  • "timezone": "Europe/Berlin"
}

Email Configuration

Email configuration

Get email configuration

Requests the email configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update email configuration

Updates the email configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
is_active
boolean

Describes if mailing is active or not.

sender
string

Sender email address

address
string

SMTP server address

port
integer

SMTP server port

security
string
Enum: "off" "starttls" "ssl"

SMTP server security

username
string

SMTP server username

password
string

SMTP server password

signature
string

Email signature

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "sender": "sender@mail.test",
  • "address": "smtp.mail.test",
  • "port": 587,
  • "security": "starttls",
  • "username": "myusername",
  • "password": "mypassword",
  • "signature": "My signature"
}

Response samples

Content type
application/json
[
  • {
    }
]

Test Email Configuration

Test Email configuration

Send test email

Send a test email. This will send a test email to the configured email address.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
sender
string

Sender email address

address
string

SMTP server address

port
integer

SMTP server port

security
string
Enum: "off" "starttls" "ssl"

SMTP server security

username
string

SMTP server username

password
string

SMTP server password

signature
string

Email signature

Responses

Request samples

Content type
application/json
{
  • "sender": "sender@mail.test",
  • "address": "smtp.mail.test",
  • "port": 587,
  • "security": "starttls",
  • "username": "myusername",
  • "password": "mypassword",
  • "signature": "My signature"
}

Locale Configuration

Locale configuration

Locale settings

Requests the language and temperature unit configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update locale settings

Updates the language and temperature unit configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
language
string
Enum: "en" "de" "fr" "it" "es" "pt" "jp"

Language code

temperature_unit
string
Enum: "C" "F"

Temperature unit

Responses

Request samples

Content type
application/json
{
  • "language": "en",
  • "temperature_unit": "C"
}

Response samples

Content type
application/json
[
  • {
    }
]

General Device Information

Device-Info

Get Device-Info

Get the Device-Info.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

DoorLocks List

Get a list of all DoorLocks

Request a list of all DoorLocks the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

DoorLock Details

Get DoorLock by ID

Requests the complete configuration of a specific DoorLock via its ID.

Authorizations:
bearer
path Parameters
doorlock_id
required
string

ID of the DoorLock to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "is_teachin_default": false,
  • "name": "Frontdoor",
  • "type": 21,
  • "signal_zonestate": false,
  • "coupletime": 3,
  • "doubleauth_mode": 0,
  • "doubleauth_timeprofile_id": 0,
  • "log_level": 1,
  • "timeprofile_mode": 0,
  • "timeprofile_id": 2,
  • "group_id": 2,
  • "armlevel": 0,
  • "webhooks": [
    ],
  • "cameras": [
    ],
  • "batterylevel": "full",
  • "reed_bypass_time": 30,
  • "reed_bypass_buzzer_time": 30,
  • "sabotage": {
    },
  • "reed_assignment": "off",
  • "reed_delay": 3600,
  • "reed_warning_active": true,
  • "reed_warning_delay": 1800
}

Update DoorLock by ID

Updates the configuration of a specific DoorLock. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
path Parameters
doorlock_id
required
string

ID of the DoorLock to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

DoorLock configuration to be updated

id
number

ID of the DoorLock

device_id
number

ID of the DoorLock's host device, i.e. the device on which is has been teached-in.

is_active
boolean

Describes if the DoorLock is active or inactive.

is_teachin_default
boolean

Describes if this DoorLock is preselected, when a RFID token will be teached-id.

name
string

Name of the DoorLock

type
number

Numerical devicetype

signal_zonestate
boolean

Set true, if the DoorLock should show the current arm state of the assigned alarmzone.

coupletime
number

Time in seconds after the booking while the door can be opened.

doubleauth_mode
number or null

Mode for double authentication. 0=Off, 1=On, 2=Only when arming/disarming, 3=time controlled via timeprofile.

doubleauth_timeprofile_id
number or null

ID of the timeprofile which shall be used to enable and disable the double authentication on specific times.

log_level
number

Sets the logbook logging mode for this DoorLock. 1=Default, 2=No user-related data (names, pictures), 3=Only unauthorized bookings, 4=No logging.

timeprofile_mode
number
Enum: 0 1 2

Mode for timeprofile usage. 0=Off, 1=On, 2=Open after first booking within the time profile.

timeprofile_id
number

ID of the DoorLock's assigned timeprofile

group_id
number

ID of the DoorLock's assigned alarmgroup

armlevel
number
Enum: 0 1 2 3 4

Set the arming level of this DoorLock. 0=Off, 1=Assigned Alarmzone, 2=Building containing the assigned Alarmzone, 3=System, 4=External Alarmsystem.

webhooks
Array of integers

IDs of all assigned webhooks.

cameras
Array of integers

IDs of all assigned cameras.

batterylevel
string
Enum: "full" "half" "low" "critical" "wired"

Battery level of the DoorLock

reed_bypass_time
number
Enum: 0 5 10 15 30 45 60 90 120

Time in seconds after the booking while the door can be opened without reed contact alarming.

reed_bypass_buzzer_time
number
Enum: 0 5 10 15 30 45 60 90 120

Time in seconds to buzzer after the bypass time and before triggering the door contact alarm.

object
reed_assignment
string

Alarm-Assignment for the assigned reed sensor.

reed_delay
number

If the reed sensor triggers an alarm, it will be delayed by this time (in seconds).

reed_warning_active
boolean

Enables signaling on the DoorLock if the door is open for the set time (in seconds). The signaling will stop when the door is closed again.

reed_warning_delay
number

The door must stay open for the set time to start the signalization.

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "is_teachin_default": false,
  • "name": "Frontdoor",
  • "type": 21,
  • "signal_zonestate": false,
  • "coupletime": 3,
  • "doubleauth_mode": 0,
  • "doubleauth_timeprofile_id": 0,
  • "log_level": 1,
  • "timeprofile_mode": 0,
  • "timeprofile_id": 2,
  • "group_id": 2,
  • "armlevel": 0,
  • "webhooks": [
    ],
  • "cameras": [
    ],
  • "batterylevel": "full",
  • "reed_bypass_time": 30,
  • "reed_bypass_buzzer_time": 30,
  • "sabotage": {
    },
  • "reed_assignment": "off",
  • "reed_delay": 3600,
  • "reed_warning_active": true,
  • "reed_warning_delay": 1800
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "is_teachin_default": false,
  • "name": "Frontdoor",
  • "type": 21,
  • "signal_zonestate": false,
  • "coupletime": 3,
  • "doubleauth_mode": 0,
  • "doubleauth_timeprofile_id": 0,
  • "log_level": 1,
  • "timeprofile_mode": 0,
  • "timeprofile_id": 2,
  • "group_id": 2,
  • "armlevel": 0,
  • "webhooks": [
    ],
  • "cameras": [
    ],
  • "batterylevel": "full",
  • "reed_bypass_time": 30,
  • "reed_bypass_buzzer_time": 30,
  • "sabotage": {
    },
  • "reed_assignment": "off",
  • "reed_delay": 3600,
  • "reed_warning_active": true,
  • "reed_warning_delay": 1800
}

Remote open DoorLock

Open DoorLock Deprecated

Remotely open a specific DoorLock. Only allowed if the user has permission to open the DoorLock or was assigned a matching access profile.

Authorizations:
bearer
path Parameters
doorlock_id
required
string

ID of the DoorLock to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Open DoorLock

Remotely open a specific DoorLock. Only allowed if the user has permission to open the DoorLock or was assigned a matching access profile.

Authorizations:
bearer
path Parameters
doorlock_id
required
string

ID of the DoorLock to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

DoorLock Information

DoorLock general information

Requests general information regarding a specific DoorLock.

Authorizations:
bearer
path Parameters
doorlock_id
required
string

ID of the DoorLock to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

DoorLock Names

Get all DoorLock names

Requests a list of all DoorLocks the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Disable multiple DoorLocks

Disable DoorLocks

Disable multiple DoorLocks and prevent any bookings on them.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • 0
]

Enable multiple DoorLocks

Enable DoorLocks

(Re-)Enable multiple DoorLocks and re-enable any bookings on them.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • 0
]

Exceptionday Profile List

Exceptionday Profiles

Get Exceptionday-Profiles

Get a list of Exceptionday-Profiles.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Add Exceptionday-Profile

Add new Exceptionday-Profile.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Exceptionday-Profile Data

id
integer

The ID of the profile (if not included a new profile with the given data will be created)

name
string

The name of the profile

Array of objects

The days, on which the exception occures

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "name": "Holidays",
  • "days": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Mass-delete Exceptionday-Profiles

Delete all given Exceptionday-Profiles.

Authorizations:
bearer
Request Body schema: application/json

Successful operation

Array
arrays

Responses

Request samples

Content type
application/json
[
  • [
    ]
]

Exceptionday Profile Details

Exceptionday Profile configuration

Get Details

Get the configuration of given Exceptionday-Profile.

Authorizations:
bearer
path Parameters
profile
required
string

Exceptionday-Profile ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update configuration

Update the configuration of given Exceptionday-Profile.

Authorizations:
bearer
path Parameters
profile
required
string

Exceptionday-Profile ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Exceptionday-Profile Data

id
integer

The ID of the profile (if not included a new profile with the given data will be created)

name
string

The name of the profile

Array of objects

The days, on which the exception occures

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "name": "Holidays",
  • "days": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete Exceptionday-Profile

Delete given Exceptionday-Profile.

Authorizations:
bearer
path Parameters
profile
required
string

Exceptionday-Profile ID

Responses

Exceptionday Import - Export

Exceptionday Import - Export

Import from ICS

Import Exceptiondays from ICS-File.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: text/calendar
required

ICS File

string <binary>

Responses

Export as ICS

Export all Exceptiondays as ICS.

Authorizations:
bearer
path Parameters
profile
required
string

Exceptionday-Profile ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Export as CSV

Export all Exceptiondays as CSV

Authorizations:
bearer
path Parameters
profile
required
string

Exceptionday-Profile ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Filterprofile List

Filterprofile List

Get the filterprofiles

Get Filterprofiles.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add a new filterprofile

Add filterprofile.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Successful operation

id
integer

The ID of the Filterprofile (If not included, a new Filterprofile with the given data will be created)

user_id
integer

The ID of the creating User

name
string

The name of the filterprofile

object
is_global
boolean

If true the filterprofile will be shown to all users

is_default
boolean

If true the filterprofile will be set as default

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "user_id": 1,
  • "name": "Alarm",
  • "filters": {
    },
  • "is_global": true,
  • "is_default": true
}

Response samples

Content type
application/json
[
  • {
    }
]

Filterprofile

Filterprofile Details

Get the details of given filterprofile

Get Filterprofile Details.

Authorizations:
bearer
path Parameters
filterprofile
required
string

Filterprofile ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "user_id": 1,
  • "name": "Alarm",
  • "filters": {
    },
  • "is_global": true,
  • "is_default": true
}

Update a new filterprofile

Update filterprofile.

Authorizations:
bearer
path Parameters
filterprofile
required
string

Filterprofile ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Successful operation

id
integer

The ID of the Filterprofile (If not included, a new Filterprofile with the given data will be created)

user_id
integer

The ID of the creating User

name
string

The name of the filterprofile

object
is_global
boolean

If true the filterprofile will be shown to all users

is_default
boolean

If true the filterprofile will be set as default

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "user_id": 1,
  • "name": "Alarm",
  • "filters": {
    },
  • "is_global": true,
  • "is_default": true
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete filterprofile

Delete filterprofile.

Authorizations:
bearer
path Parameters
filterprofile
required
string

Filterprofile ID

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

GSM Configuration

Get GSM status

Requests status information of the GSM.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "authentication": false,
  • "state": {
    },
  • "gateway": {
    },
  • "forwarding": {
    }
}

Update GSM configuration

Updates the GSM configuration.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

GSM configuration

is_active
boolean

Describes if GSM/cell service is active or not.

object
object

Only for SiteManagers without GSM modem. If enabled, all SMS will be forwarded to the AlarmManager IP and sent via it's modem.

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "gateway": {
    },
  • "forwarding": {
    }
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "authentication": false,
  • "state": {
    },
  • "gateway": {
    },
  • "forwarding": {
    }
}

Get cell state

Requests status information of cell state.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "state": "ready",
  • "signal_strength": "medium"
}

SIM Configuration

Send test sms

Send test sms to provided phone number.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
phone
string

Phone number to which the test SMS should be sent.

Responses

Request samples

Content type
application/json
{
  • "phone": "+123456789"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Set SIM card PIN

Configuration options to set the PIN of the SIM card.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
pin
string

SIM cards current PIN.

Responses

Request samples

Content type
application/json
{
  • "pin": "1234"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Unlock SIM card

Unlock the SIM card with PUK and set a new PIN.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
puk
string

SIM cards PUK.

pin
string

SIM cards new PIN.

Responses

Request samples

Content type
application/json
{
  • "puk": "12345678",
  • "pin": "1234"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Change SIM card PIN

Configuration options to change the PIN of the SIM card.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
old_pin
string

SIM cards current PIN.

new_pin
string

SIM cards new PIN.

Responses

Request samples

Content type
application/json
{
  • "old_pin": "1234",
  • "new_pin": "1234"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Set SIM card PIN

Configuration options for the PIN protection of the SIM card.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
active
boolean

Describes if SIM protection should be active or not.

pin
string

SIM cards current PIN.

Responses

Request samples

Content type
application/json
{
  • "active": true,
  • "pin": "1234"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

SMS Gateway Configuration

Get SMS gateway configuration

Requests the SMS gateway information for sending SMS messages.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "password": "password"
}

Update SMS gateway configuration

Update the SMS gateway information for sending SMS messages.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required
is_active
boolean

Describes if SMS gateway is active or not.

password
string or null

Password for the SMS-Gateway.

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "password": "password"
}

Send SMS to recipients

Sends an SMS with given content to given recipients.

Authorizations:
bearer
Request Body schema: application/json
required
key
string

Password for the SMS-Gateway.

recipients
Array of strings

Persons to whom the SMS is to be sent.

body
string

Body of the SMS.

alarm_event_id
integer or null

The ID of the alarm event

retries
integer or null

Attempts to send SMS

Responses

Request samples

Content type
application/json
{
  • "key": "password",
  • "recipients": [
    ],
  • "body": "This is an example",
  • "alarm_event_id": 0,
  • "retries": 0
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Integration

Integration of an existing system

Start the integration of an existing system

Starts the integration of an existing system.

Authorizations:
bearer
Request Body schema: application/json
required

Data of the main device of the system to be integrated

address
string

The address of the device.

apikey
string

The apikey of an admin of the device to be integrated.

Responses

Request samples

Content type
application/json
{
  • "address": "192.168.100.224",
  • "apikey": "mfyLv9Y263tOd6xTMM94yzBHtVID7rvQCcEbQXaI"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Get the report of the last integration.

Get the report of the last integration.

Authorizations:
bearer

Responses

Response samples

Content type
application/json
{
  • "step": {
    }
}

IO-Module List

IO-Modules

Get IO-Modules

Get a list of all IO-Modules.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

IO-Module Names

IO-Module Names

Get IO-Module names

Get a list of IO-Module names.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

IO-Module Details

IO-Module configuration

Get Details

Get the details of the given IO-Module.

Authorizations:
bearer
path Parameters
iomodule
required
string

IO-Module ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
Example
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Kentix I/O Module 7017",
  • "type": 123,
  • "address": "192.168.0.1",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of given IO-Module.

Authorizations:
bearer
path Parameters
iomodule
required
string

IO-Module ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

One of
id
integer

the ID of the device

device_id
integer

the ID of the device this device is assigned to

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

type
integer

The type of the device

address
string

The address of the device

port
integer

The port of the device

group_id
integer

The ID of the group the device is assigned to

rack_id
integer

The ID of the rack the device is assigned to

object
object
webhooks
Array of arrays

The webhook relations of this device

Responses

Request samples

Content type
application/json
Example
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Kentix I/O Module 7017",
  • "type": 123,
  • "address": "192.168.0.1",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Kentix I/O Module 7017",
  • "type": 123,
  • "address": "192.168.0.1",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

KPIs

KPI configuration

Get configuration

Get the KPI configuration for the given user.

Authorizations:
bearer
path Parameters
user
required
string

User ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update configuration

Update the KPI configuration for the given user.

Authorizations:
bearer
path Parameters
user
required
string

User ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

KPIs Data

user_id
integer

The ID of the user related to the configuration

object

Responses

Request samples

Content type
application/json
{
  • "user_id": 1,
  • "config": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

LDAP Settings

LDAP

Get LDAP settings

Get the LDAP settings

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "soft_deletes": false,
  • "security": 1,
  • "address": "ldap.example.com",
  • "port": 389,
  • "basedn": "dc=example,dc=com",
  • "binddn": "cn=admin,dc=example,dc=com",
  • "binddn_password": "password",
  • "usergroup_1": 1,
  • "usergroup_1_path": "cn=users,ou=groups,dc=example,dc=com",
  • "usergroup_2": 2,
  • "usergroup_2_path": "cn=admins,ou=groups,dc=example,dc=com",
  • "admin_group": "cn=admins,ou=groups,dc=example,dc=com",
  • "user_active": "active",
  • "username": "sAMAccountName",
  • "fullname": "name",
  • "email": "mail",
  • "phone": "telephoneNumber",
  • "pin": "pin",
  • "rfid": "rfid",
  • "description": "description",
  • "emergency_access": "emergency",
  • "notifications": "receives_notifications",
  • "levelprofiles": "accessprofiles",
  • "sync_interval": 3600
}

Update LDAP settings

Update the LDAP settings

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
is_active
boolean

Is LDAP active

soft_deletes
boolean

Describes, if deleted users should be disabled or deleted. If true, the user will be disabled.

security
integer
Enum: 0 1

Describes the security level of the LDAP connection. 0 = None 1 = SSL (LDAPS)

address
string

LDAP server address

port
integer

LDAP server port

basedn
string

LDAP base DN

binddn
string

LDAP bind DN

binddn_password
string

LDAP bind DN password

usergroup_1
integer

ID of the Kentix system usergroup, which should be used for LDAP usergroup 1

usergroup_1_path
string

LDAP usergroup 1 path

usergroup_2
integer

ID of the Kentix system usergroup, which should be used for LDAP usergroup 2

usergroup_2_path
string

LDAP usergroup 2 path

admin_group
string

LDAP admin group

user_active
string

LDAP user active attribute

username
string

LDAP username attribute

fullname
string

LDAP fullname attribute

email
string

LDAP email attribute

phone
string

LDAP phone attribute, only required for AlarmManagers

pin
string

LDAP pin attribute

rfid
string

LDAP rfid attribute

description
string

LDAP description attribute

emergency_access
string

LDAP emergency access attribute

notifications
string

LDAP attribute to describe if a user may receive notifications

levelprofiles
string

LDAP attribute to describe the accessprofiles of a user

sync_interval
integer
Enum: 3600 10800 21600 43200 86400

LDAP sync interval in seconds

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "soft_deletes": false,
  • "security": 1,
  • "address": "ldap.example.com",
  • "port": 389,
  • "basedn": "dc=example,dc=com",
  • "binddn": "cn=admin,dc=example,dc=com",
  • "binddn_password": "password",
  • "usergroup_1": 1,
  • "usergroup_1_path": "cn=users,ou=groups,dc=example,dc=com",
  • "usergroup_2": 2,
  • "usergroup_2_path": "cn=admins,ou=groups,dc=example,dc=com",
  • "admin_group": "cn=admins,ou=groups,dc=example,dc=com",
  • "user_active": "active",
  • "username": "sAMAccountName",
  • "fullname": "name",
  • "email": "mail",
  • "phone": "telephoneNumber",
  • "pin": "pin",
  • "rfid": "rfid",
  • "description": "description",
  • "emergency_access": "emergency",
  • "notifications": "receives_notifications",
  • "levelprofiles": "accessprofiles",
  • "sync_interval": 3600
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "soft_deletes": false,
  • "security": 1,
  • "address": "ldap.example.com",
  • "port": 389,
  • "basedn": "dc=example,dc=com",
  • "binddn": "cn=admin,dc=example,dc=com",
  • "binddn_password": "password",
  • "usergroup_1": 1,
  • "usergroup_1_path": "cn=users,ou=groups,dc=example,dc=com",
  • "usergroup_2": 2,
  • "usergroup_2_path": "cn=admins,ou=groups,dc=example,dc=com",
  • "admin_group": "cn=admins,ou=groups,dc=example,dc=com",
  • "user_active": "active",
  • "username": "sAMAccountName",
  • "fullname": "name",
  • "email": "mail",
  • "phone": "telephoneNumber",
  • "pin": "pin",
  • "rfid": "rfid",
  • "description": "description",
  • "emergency_access": "emergency",
  • "notifications": "receives_notifications",
  • "levelprofiles": "accessprofiles",
  • "sync_interval": 3600
}

LDAP Sync

LDAP Sync

Synchronize LDAP users

Start an LDAP sync

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Levelprofile List

Get levelprofiles

Get all levelprofiles

Requests all levelprofiles which the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Create levelprofile

Creates a new levelprofile.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Levelprofile configuration to be added

name
string

Name of the levelprofile

timeprofile_id
integer

Id of the assigned timeprofile

doorlocks
Array of integers

Ids of the doorlocks

Responses

Request samples

Content type
application/json
{
  • "name": "Levelprofile",
  • "timeprofile_id": 1,
  • "doorlocks": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Levelprofile Details

Get a specific levelprofile by an Id

Get levelprofile by ID

Requests the levelprofile via its ID.

Authorizations:
bearer
path Parameters
levelprofile_id
required
string

ID of the levelprofile to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update levelprofile by ID

Updates the configuration of a specific levelprofile. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
path Parameters
levelprofile_id
required
string

ID of the levelprofile to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Levelprofile configuration to be updated

name
string

Name of the timeprofile

timeprofile_id
integer

Id of the timeprofile connected to the levelprofile

doorlocks
Array of integers

Id of the doorlocks

Responses

Request samples

Content type
application/json
{
  • "name": "Levelprofile",
  • "timeprofile_id": 1,
  • "doorlocks": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete a single levelprofile

Delete the levelprofile with a specific id.

Authorizations:
bearer
path Parameters
levelprofile_id
required
string

ID of the levelprofile to be deleted

Responses

Levelprofile Names

Get the names of the levelprofiles

Levelprofiles names

Requests a list of all levelprofiles the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Massedit

Massedit

Massedit

Send a massedit request.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Massedit Data

object

An Object that contains all ids of the devices to be edited

fields
object

An Object that contains all the fields and their values to be edited (Remember to properly layer the fields e.g. temerature and dewpoint have to be inside of monitoring)

Responses

Request samples

Content type
application/json
{
  • "ids": {
    },
  • "fields": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Measurements

Measurements of the devices

Get Systemvalues

Requests the Systemvalues of the device. The Systemvalues contain all sensor data and devices list informations.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Systemvalues of a specific device

Requests the Systemvalues of a specific device, which contains the sensor data.

Authorizations:
bearer
path Parameters
id
required
string

Device ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

MultiSensor List

MultiSensors

Get MultiSensors

Get a list of all MultiSensors.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

MultiSensor Names

MultiSensor Names

Get MultiSensor names

Get the names of all MultiSensors.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

MultiSensor Details

MultiSensor configuration

Get Details

Get the configuration of given MultiSensor.

Authorizations:
bearer
path Parameters
multisensor
required
string

MultiSensor ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "type": 1,
  • "type_name": "MultiSensor-RF",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "ir_color_mode": "color",
  • "ir_custom_range": true,
  • "ir_distance": 250,
  • "ir_emissivity": "0.9499999999999999996",
  • "ir_max_value": 1500,
  • "ir_min_value": 1000,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of given MultiSensor.

Authorizations:
bearer
path Parameters
multisensor
required
string

MultiSensor ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

device_id
integer

the ID of the device this device is assigned to

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

description
string

The description of the device

type
integer

The type of the device

type_name
string

The name of the type

address
string

The address of the device

alarmdelay
integer

The amount of seconds an alarm will be delayed

object

co2 and air_quality MultiSensorTI only

object

air_quality MultiSensorTI only

object
ir_color_mode
string
Enum: "color" "gray"

[MultiSensor-TI only] The mode in which the data is given

ir_custom_range
boolean

[MultiSensor-TI only] The flag, if a custom range is active

ir_distance
integer

[MultiSensor-TI only] The distance between the device and the ground (in cm)

ir_emissivity
string

[MultiSensor-TI only] The emissivity

ir_max_value
integer

[MultiSensor-TI only] The max value for scaling the temperature

ir_min_value
integer

[MultiSensor-TI only] The min value for scaling the temperature

group_id
integer

The ID of the group the device is assigned to

rack_id
integer

The ID of the rack the device is assigned to

object
object
Array of objects

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "type": 1,
  • "type_name": "MultiSensor-RF",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "ir_color_mode": "color",
  • "ir_custom_range": true,
  • "ir_distance": 250,
  • "ir_emissivity": "0.9499999999999999996",
  • "ir_max_value": 1500,
  • "ir_min_value": 1000,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "type": 1,
  • "type_name": "MultiSensor-RF",
  • "address": "192.168.0.1",
  • "alarmdelay": 10,
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "ir_color_mode": "color",
  • "ir_custom_range": true,
  • "ir_distance": 250,
  • "ir_emissivity": "0.9499999999999999996",
  • "ir_max_value": 1500,
  • "ir_min_value": 1000,
  • "group_id": 1,
  • "rack_id": null,
  • "external": {
    },
  • "output": {
    },
  • "webhooks": [
    ]
}

Network-Sensor List

Network-Sensors

Get Network-Sensors

Get a list of all Network-Sensors.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Network-Sensor Names

Network-Sensor Names

Get Network-Sensor names

Get the names of all Network-Sensors.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Network-Sensor Details

Network-Sensor configuration

Get Details

Get the configuration of given Network-Sensors.

Authorizations:
bearer
path Parameters
sensor
required
string

Network-Sensor ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "type": 142,
  • "name": "Network-Sensor",
  • "address": "192.168.0.1",
  • "port": 8080,
  • "description": "Network-Sensor Server1",
  • "service_type": "ping",
  • "service_interval": 180,
  • "protocol": "http",
  • "alarmvalue": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of given Network-Sensor.

Authorizations:
bearer
path Parameters
sensor
required
string

Network-Sensor ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

is_active
boolean

The flag to determine the status of the device

type
integer

The type of the device

name
string

The name of the device

address
string

The address of the device

port
integer

If service_type is port the monitored port is set here

description
string

The description of the device

service_type
string
Enum: "ping" "port"

The type of sensor

service_interval
integer

Interval in which the given server is checked

protocol
string
Enum: "http" "https"

The protocol to be used

object
group_id
integer

The ID of the group the device is assigned to

rack_id
integer

The ID of the rack the device is assigned to

Array of objects

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "type": 142,
  • "name": "Network-Sensor",
  • "address": "192.168.0.1",
  • "port": 8080,
  • "description": "Network-Sensor Server1",
  • "service_type": "ping",
  • "service_interval": 180,
  • "protocol": "http",
  • "alarmvalue": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "type": 142,
  • "name": "Network-Sensor",
  • "address": "192.168.0.1",
  • "port": 8080,
  • "description": "Network-Sensor Server1",
  • "service_type": "ping",
  • "service_interval": 180,
  • "protocol": "http",
  • "alarmvalue": {
    },
  • "group_id": 1,
  • "rack_id": null,
  • "webhooks": [
    ]
}

Network Configuration

Network configuration

Get network configuration

Requests the network configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update network configuration

Updates the network configuration of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
dhcp_active
boolean

Describes if DHCP is active or not.

dhcp_address
string

DHCP IP address of the device.

dhcp_netmask
string

DHCP netmask of the device.

static_active
boolean

Describes if static IP is active or not.

static_address
string or null

Static IP address of the device.

static_netmask
string

Static netmask of the device.

gateway
string

Network gateway of the device.

dns1
string

Primary DNS server of the device.

dns2
string

Secondary DNS server of the device.

dyndns_address
string

Dynymic DNS address of the device.

object

IEEE 802.1X port authentication settings.

Responses

Request samples

Content type
application/json
{
  • "dhcp_active": true,
  • "dhcp_address": "192.168.100.224",
  • "dhcp_netmask": "255.255.255.0",
  • "static_active": false,
  • "static_address": "192.168.100.224",
  • "static_netmask": "255.255.255.0",
  • "gateway": "192.168.100.1",
  • "dns1": "192.168.100.1",
  • "dns2": "192.168.100.2",
  • "dyndns_address": "my-alarmmanager.internal.mycompany.com",
  • "port_auth": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

SSL Certificate Configuration

SSL Certificate configuration

Get SSL certificate

Requests the SSL certificate of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Upload SSL certificate

Uploads a new SSL certificate to the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/octet-stream
required

The SSL certificate to upload.

string <binary>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete SSL certificate

Deletes the SSL certificate of the device.

Authorizations:
bearer

Responses

Personalizations

Get Personalizations

Get the start default-view

Requests the start default-view.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "defaultview_start": "topology"
}

Update the start default-view

Updates the start default-view. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Default-view configuration to be updated

detailview_start
string
Enum: "topology" "grid" "list"

Responses

Request samples

Content type
application/json
{
  • "detailview_start": "topology"
}

Response samples

Content type
application/json
[
  • {
    }
]

Personalization background

Personalization of the background image

Update background image.

Updates the current background image.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Backround image configuration to be updated

background_image
string <binary>

Responses

Request samples

Content type
application/json
{
  • "background_image": "string"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Personalization default view

Get the current default-view

Get the current default-view

Requests the current default-view the user has selected.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "defaultview": "topology"
}

Background image

Get or delete the background image

Get the current default-view

Requests the current background image.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
"string"

Deletes the backgound image

Delete the current background image.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

SmartPDU Names

Get Powermanager names

Requests all Powernanagers which the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SmartPDU List

Get Powermanagers

Get all Powermanagers.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

SmartPDU Details

Get Powermanager

Get a specific Powermanager via its ID.

Authorizations:
bearer
path Parameters
powermanager_id
required
string

ID of the Powermanager to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "name": "KentixPDU",
  • "type": 109,
  • "group_id": 1,
  • "is_active": true,
  • "address": "192.168.100.226",
  • "synchronicity": {
    },
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "meter_type": 0,
  • "uses_signed_integers": 1,
  • "rcm_serial": "",
  • "rcm_address": "100",
  • "rcm": {
    },
  • "phases": [
    ],
  • "rack_id": 1,
  • "webhooks": [
    ],
  • "external": {
    },
  • "output": {
    }
}

Update Powermanager

Update a specific Powermanager via its ID.

Authorizations:
bearer
path Parameters
powermanager_id
required
string

ID of the Powermanager to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Name of the Powermanager.

type
integer

Type of the Powermanager.

group_id
integer or null

Indicates the alarmgroup of the Powermanager.

is_active
boolean

Describes if the Powermanager is active.

address
string

IP address of the Powermanager.

object

The configuration for the synchronicity sensor

object

Only for kmpdu

object

Only for kmpdu

object

Only for kmpdu

meter_type
integer

Type for Energy efficiency measuring. Only for SmartPDU

uses_signed_integers
integer

Determines the prefix display. Only for SmartPDU

rcm_serial
string or null

Describes the serial of the RCM. Only for SmartPDU

rcm_address
string

Describes the address of the RCM. Only for SmartPDU

object

Only for kmpdu

Array of objects

Only for SmartPDU

rack_id
integer

Rack Id which the Powermanager belongs to.

webhooks
Array of integers

IDs of all assigned webhooks.

object
object

Responses

Request samples

Content type
application/json
{
  • "name": "KentixPDU",
  • "type": 109,
  • "group_id": 1,
  • "is_active": true,
  • "address": "192.168.100.226",
  • "synchronicity": {
    },
  • "monitoring": {
    },
  • "fire": {
    },
  • "intrusion": {
    },
  • "meter_type": 0,
  • "uses_signed_integers": 1,
  • "rcm_serial": "",
  • "rcm_address": "100",
  • "rcm": {
    },
  • "phases": [
    ],
  • "rack_id": 1,
  • "webhooks": [
    ],
  • "external": {
    },
  • "output": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

SmartPDU overview

Get SmartPDU overview

Get the overview of the supply of a SmartPDU.

Authorizations:
bearer
path Parameters
kpmdu_id
required
string

ID of the KPM_PDU to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "width": 2,
  • "height": 27,
  • "pdu_subgroups": [
    ],
  • "phases": [
    ],
  • "fuses": [
    ],
  • "outletblocks": [
    ],
  • "outlets": [
    ],
  • "units": {
    }
}

Outlet overview

Get outlet

Get a specific outlet via its ID.

Authorizations:
bearer
path Parameters
outlet_id
required
string

ID of the outlet to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "1-1",
  • "switch_dual": false
}

Update outlet

Update a specific outlet via its ID.

Authorizations:
bearer
path Parameters
outlet_id
required
string

ID of the outlet to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Name of the outlet

switch_dual
boolean or null

Describes if the associated outlet should be switched as well.

Responses

Request samples

Content type
application/json
{
  • "name": "1-1",
  • "switch_dual": false
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "1-1",
  • "switch_dual": false
}

Switch outlet

Switch outlet

Switches an outlet.

Authorizations:
bearer
path Parameters
outlet_id
required
integer

ID of the outlet to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
mode
required
string
Enum: "on" "off" "toggle"

Describes the target status of the outlet.

duration
number or null
Default: null

Time in seconds for the outlet to be switched. After this time has passed, the outlet will be switched back to it's initial state. Omitting the attribute or a value of null will be interpreted as permanent switching. A value of 0 will ignore the command.

delay
number or null
Default: null

Time in seconds before the switching will be executed. Omitting the attribute, a value of null or a value of 0 will switch with no delay.

dual
boolean or null
Default: false

If a dual SmartPDU or a rack unit with exactly 1 line a device and exactly 1 lane b device is used, the mirrored outlet can be switched synchronously. By setting this attribute to true, the mirrored outlet of the addressed one will be switched, too. If omitted or set to null, no dual switching will be executed.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Privacy Configuration

Privacy configuration

Privacy settings

Requests the privacy settings of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update privacy settings

Updates the privacy settings of the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
memorydepth
number [ 0 .. 720 ]

Sets the number of days during which all user-related data (bookings, images, etc) is stored. 0 = Unlimited, must be between 0 and 720.

Responses

Request samples

Content type
application/json
{
  • "memorydepth": 1
}

Response samples

Content type
application/json
[
  • {
    }
]

Current user profile

User profile

Get user profile

Requests the profile of the currently authenticated user.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "username": "erika.schmidt",
  • "password": "pvg4HXvj9WG4KPnN",
  • "fullname": "Erika Schmidt",
  • "email": "erika.schmidt@example.com",
  • "autologout": 120,
  • "is_admin": false,
  • "usergroup": {
    },
  • "filterprofile_id": 4,
  • "tableview_id": 3
}

Update user profile

Updates the profile of the currently authenticated user.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
password
string

A new password or the static replacement to keep the password.

fullname
string

The full name of the currently authenticated user.

email
string or null

The email address of the currently authenticated user.

autologout
integer or null
Enum: 5 15 30 60 120 360 720

The time in minutes for auto logout or null to disable it.

filterprofile_id
integer

Describes the ID of the personal default filter profile.

tableview_id
integer

Describes the ID of the personal default table view.

Responses

Request samples

Content type
application/json
{
  • "password": "top-secret",
  • "fullname": "Erika Schmidt",
  • "email": "erika.schmidt@example.com",
  • "autologout": 120,
  • "filterprofile_id": 4,
  • "tableview_id": 3
}

Response samples

Content type
application/json
{
  • "username": "erika.schmidt",
  • "password": "pvg4HXvj9WG4KPnN",
  • "fullname": "Erika Schmidt",
  • "email": "erika.schmidt@example.com",
  • "autologout": 120,
  • "is_admin": false,
  • "usergroup": {
    },
  • "filterprofile_id": 4,
  • "tableview_id": 3
}

Get users shortcuts

Requests the shortcuts linked to the current user.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update users shortcut list

Updates the list of linked shortcuts.

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
id
number

The id of the shortcut

name
string

The name of the shortcut

viewmode
number
Enum: 0 1 2

The modus of the link. 0 => URL, 1=> Detail View (Grid), 2 => Detail View (Table)

url
string or null

The url the shortcut links to

filterprofile_id
number or null

The id of the linked filterprofile in the grid view of the Detail View

tableview_id
number or null

The id of the linked tableview in the table view of the Detail View

icon
string

The icon to be shown for the shortcut

default
boolean

The flag that determines, if this shortcut will be linked to all new users

permission
string or null

The name of the permission needed to see/ use this shortcut

object

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

(Un)Set default shortcut

Sets or unsets the shortcut as default for new users

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
quicklink_id
number

The id of the shortcut to (un)set as default

Responses

Request samples

Content type
application/json
{
  • "quicklink_id": 3
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Rack List

Racks

Get racks

Get a list of all racks.

Authorizations:
bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add Rack

Add a new rack.

Authorizations:
bearer
Request Body schema: application/json
name
string

The name to give the new Rack

group_id
integer

The ID of the alarmgroup this rack will belong to

Responses

Request samples

Content type
application/json
{
  • "name": "Rack",
  • "group_id": 1
}

Response samples

Content type
application/json
{
  • "group_id": 1,
  • "id": 2,
  • "is_active": true,
  • "name": "Rack",
  • "description": "Rack Server1",
  • "devices": [
    ],
  • "ios": [
    ],
  • "synchronicity": {
    },
  • "activepower": {
    },
  • "webhooks": [
    ]
}

Rack Names

Rack Names

Get rack names

Get a list of the names of all racks.

Authorizations:
bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Rack Details

Rack Details

Get details

Get the configuration of the given rack.

Authorizations:
bearer
path Parameters
rack
required
string

Rack ID

Responses

Response samples

Content type
application/json
{
  • "group_id": 1,
  • "id": 2,
  • "is_active": true,
  • "name": "Rack",
  • "description": "Rack Server1",
  • "devices": [
    ],
  • "ios": [
    ],
  • "synchronicity": {
    },
  • "activepower": {
    },
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of the given rack.

Authorizations:
bearer
path Parameters
rack
required
string

Rack ID

Request Body schema: application/json
group_id
integer

The ID of the group the device is assigned to

id
integer

the ID of the device

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

description
string

The description of the device

Array of objects

Contains an array of devices and their supplyline- and synchronicity assignments. These are only relevant if the devices are PDUs

ios
Array of integers

Contains an array of IO-IDs that are assigned to this rack

object

The configuration for the synchronicity sensor

object

The configuration for the activepower sensor

Array of objects

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "group_id": 1,
  • "id": 2,
  • "is_active": true,
  • "name": "Rack",
  • "description": "Rack Server1",
  • "devices": [
    ],
  • "ios": [
    ],
  • "synchronicity": {
    },
  • "activepower": {
    },
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "group_id": 1,
  • "id": 2,
  • "is_active": true,
  • "name": "Rack",
  • "description": "Rack Server1",
  • "devices": [
    ],
  • "ios": [
    ],
  • "synchronicity": {
    },
  • "activepower": {
    },
  • "webhooks": [
    ]
}

Delete rack

Delete the given rack.

Authorizations:
bearer
path Parameters
rack
required
string

Rack ID

Responses

Attach Rack to Alarmgroup

Attach Rack

Attach Rack

Attach a rack to an alarmgroup.

Authorizations:
bearer
path Parameters
alarmgroup
required
string

Alarmgroup ID

rack
required
string

Rack ID

Responses

Report List

Reports

Get Reports

Get all reports

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Add Report

Add new report

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

The ID of the report

name
string

The name of the Report

type
integer
Enum: 0 1

The type of report. 0 = all data, 1 = sum

interval_mode
integer
Enum: 1 2 3 4

The Interval in which the report is sent. 1 = daily, 2 = weekly, 3 = monthly, 4 = yearly

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "name": "Example-Report",
  • "type": 0,
  • "interval_mode": 2
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Example-Report",
  • "type": 0,
  • "interval_mode": 2
}

Report Names

Report Names

Get Report Names

Get all report names

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Report Details

Report Details

Get Report Details

Get details of given Report

Authorizations:
bearer
path Parameters
report
required
integer

Report ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Example-Report",
  • "type": 0,
  • "interval_mode": 2
}

Update Report

Update given Report

Authorizations:
bearer
path Parameters
report
required
integer

Report ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

The ID of the report

name
string

The name of the Report

type
integer
Enum: 0 1

The type of report. 0 = all data, 1 = sum

interval_mode
integer
Enum: 1 2 3 4

The Interval in which the report is sent. 1 = daily, 2 = weekly, 3 = monthly, 4 = yearly

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "name": "Example-Report",
  • "type": 0,
  • "interval_mode": 2
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Example-Report",
  • "type": 0,
  • "interval_mode": 2
}

Delete Report

Delete given Report

Authorizations:
bearer
path Parameters
report
required
integer

Report ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Send Test Report

Send Test Report

Send Test Report

Send test report

Authorizations:
bearer
path Parameters
report
required
integer

Report ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Factory Reset

Reset the device

Factory Reset

Initiate a factory reset. This will delete all data on the device and restore it to its factory defaults.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

The device will reboot after the reset is complete. The device will not be reachable for a few minutes.

reboot
boolean

Reboot the Device.

reset_network
boolean

Reset the Network Settings.

Responses

Request samples

Content type
application/json
{
  • "reboot": true,
  • "reset_network": true
}

Reboot

Reboot the device

Reboot

Reboot the device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Satellites

Functions to get Satellites

Get a list of all satellites.

Request all the satellites.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 43,
  • "type": 110,
  • "device_type": "KXP",
  • "name": "AccessManager Satellite",
  • "os_revision": 2,
  • "fw_version": "08.01.02 B00944",
  • "is_satellite": true,
  • "mac_address": "00:11:22:33:44:55",
  • "address": "192.168.100.224",
  • "update_available": false,
  • "update_state": 0,
  • "enable_sync": true
}

Satellites Settings

Functions to get and update the Satellite settings.

Get the satellites settings

Request the satellites settings.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "device_name": "AccessManager",
  • "is_active": true,
  • "manager_address": "192.168.100.224"
}

Update the Satellite settings.

Updates the settings of the satellite. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Satellite settings configuration to be updated.

is_active
boolean

Indicates if this satellite is enabled.

manager_address
string

Network address of the manager to which this slave is assigned.

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "manager_address": "192.168.100.224"
}

Response samples

Content type
application/json
[
  • {
    }
]

Satellite Synchronization

Functions to manage the Satellite synchronization process.

Get the synchronization status of the Satellites.

Get the synchronization status of the Satellites.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "has_satellites": true,
  • "is_runnig": false,
  • "is_unsynced": true
}

Start the Satellite data synchronization.

Start the Satellite data synchronization.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "has_satellites": true,
  • "is_runnig": false,
  • "is_unsynced": true
}

Satellite Update

Functions to get, delete and update Satellites

Get the status of the Satellites-Update.

Get the status of the Satellites-Update.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_running": false,
  • "queued": 0
}

Checks for available updates.

THe device checks for each connected Satellite i there is an update available. If an update is available it will be added to the update-queue.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Delete all queued updates at once.

Delete all queued updates at once.

Authorizations:
bearer

Responses

Response samples

Content type
application/json
{
  • "name": "AccessManager Satellite",
  • "address": "192.168.100.224",
  • "enable_sync": true
}

Satellites Firmware

Function to get and modify firmwares.

Get a list of all stored firmware files.

Get a list of all stored firmware files.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 43,
  • "type": 110,
  • "device_type": "KXP",
  • "name": "AccessManager Satellite",
  • "os_revision": 2,
  • "fw_version": "08.01.02 B00944",
  • "is_satellite": true,
  • "mac_address": "00:11:22:33:44:55",
  • "address": "192.168.100.224",
  • "update_available": false,
  • "update_state": 0,
  • "enable_sync": true
}

Upload a new firmware image for the satellite update.

Upload a new firmware image for the satellite update.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Firmware image for the satellite update.

firmware
string

The firmware file to be uploaded.

Responses

Request samples

Content type
application/json
{
  • "firmware": "Firmware string"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Satellite specific Firmware

Function to delete a specific firmware.

Removes a specific firmware file.

Removes a specific firmware file via the ID.

Authorizations:
bearer
path Parameters
firmware_id
required
string

ID of the Firmware to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Satellite Firmware status

Get the current firmware status for the satellite update.

Current firmware status for the satellite update.

Get the current firmware status for the satellite update.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "status": 0
}

OTA satellite Download

Start the OTA download for the satellite firmwares.

Start satellite OTA download.

Start downloading the firmware files for all satellites. Only usable with a valid and active KentixONE license.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "has_satellites": true,
  • "is_runnig": false,
  • "is_unsynced": true
}

SD Card

SD Card

Get the SD card status

Get the SD card status

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "present": true,
  • "mounted": true,
  • "label": "SD_CARD",
  • "capacity": "16GB",
  • "used": "1GB",
  • "available": "15GB"
}

Erase the SD card

Erase the SD card

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "present": true,
  • "mounted": true,
  • "label": "SD_CARD",
  • "capacity": "16GB",
  • "used": "1GB",
  • "available": "15GB"
}

Communication Key

Security

Get communication key

Get the communication key.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "communication-key": "myCommunicationKey0123456789",
  • "pinlength": 4,
  • "rfid-mode": 0
}

Update communication key

Update the communication key.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
communication-key
string

The communication key of the device.

pinlength
integer [ 4 .. 10 ]

The length of the PIN.

rfid-mode
integer
Enum: 0 1 2

The RFID mode of the device. 0=disabled, 1=Kentix-Encryption, 2=Custom-Encryption.

Responses

Request samples

Content type
application/json
{
  • "communication-key": "myCommunicationKey0123456789",
  • "pinlength": 4,
  • "rfid-mode": 0
}

Response samples

Content type
application/json
{
  • "communication-key": "myCommunicationKey0123456789",
  • "pinlength": 4,
  • "rfid-mode": 0
}

Output Switching

Switch output Deprecated

Switches a specific output of the device.

Authorizations:
bearer
path Parameters
device_id
required
string

ID of the device, whose output should be switched

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Specification of the switching process

Array
type
string
Enum: "BUZZER" "LEDRED" "LEDGREEN" "DO1" "DO2" "DO3" "DO4" "DO5" "DO6" "DO7" "DO8"

The output to be switched

mode
required
string
Enum: "ON" "OFF" "PULSE"

Defines the switching mode. ON: Switches the output constantly on. OFF: Switches the output constantly off. PULSE: Toggles the output between on and off in a one second interval.

duration
number or null
Default: null

Period of time in seconds to signal on the selected output. Can be NULL or any integer number. Can be omitted, which will be evaluated the same as NULL or 0. If omitted or set to NULL, the signaling will be continuous.

delay
number or null
Default: null

Delay in seconds before this signaling command is executed. Can be NULL or any integer number. Can be omitted, which will be evaluated the same as NULL or 0. If omitted or set to NULL, the signaling will start instantly.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Switch output

Switches a specific output of the device.

Authorizations:
bearer
path Parameters
device_id
required
string

ID of the device, whose output should be switched

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Specification of the switching process

Array
type
string
Enum: "BUZZER" "LEDRED" "LEDGREEN" "DO1" "DO2" "DO3" "DO4" "DO5" "DO6" "DO7" "DO8"

The output to be switched

mode
required
string
Enum: "ON" "OFF" "PULSE"

Defines the switching mode. ON: Switches the output constantly on. OFF: Switches the output constantly off. PULSE: Toggles the output between on and off in a one second interval.

duration
number or null
Default: null

Period of time in seconds to signal on the selected output. Can be NULL or any integer number. Can be omitted, which will be evaluated the same as NULL or 0. If omitted or set to NULL, the signaling will be continuous.

delay
number or null
Default: null

Delay in seconds before this signaling command is executed. Can be NULL or any integer number. Can be omitted, which will be evaluated the same as NULL or 0. If omitted or set to NULL, the signaling will start instantly.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Sitemanager List

Sitemanagers

Get SiteManagers

Get a list of all SiteManagers.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Sitemanager Names

Sitemanager Names

Get Sitemanager names

Get a list of all SiteManager names.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Sitemanager Details

Sitemanager configuration

Get SiteManager Details

Get the configuration of given SiteManager.

Authorizations:
bearer
path Parameters
sitemanager
required
string

SiteManager ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "SiteManager",
  • "type": 113,
  • "is_active": true,
  • "address": "192.168.0.1",
  • "group_id": 1,
  • "mac_address": "12:34:56:78:90:ab",
  • "rack_id": null,
  • "webhooks": [
    ]
}

Update SiteManager configuration

Update the configuration of given SiteManager.

Authorizations:
bearer
path Parameters
sitemanager
required
string

SiteManager ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

name
string

The name of the device

type
integer

The type of the device

is_active
boolean

The flag to determine the status of the device

address
string

The address of the device

group_id
integer

The ID of the group the device is assigned to

mac_address
string

The MAC-Address of the device

rack_id
integer

The ID of the rack the device is assigned to

Array of objects

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "name": "SiteManager",
  • "type": 113,
  • "is_active": true,
  • "address": "192.168.0.1",
  • "group_id": 1,
  • "mac_address": "12:34:56:78:90:ab",
  • "rack_id": null,
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "SiteManager",
  • "type": 113,
  • "is_active": true,
  • "address": "192.168.0.1",
  • "group_id": 1,
  • "mac_address": "12:34:56:78:90:ab",
  • "rack_id": null,
  • "webhooks": [
    ]
}

SmartMeter List

SmartMeters

Get SmartMeters

Get a list of all SmartMeters.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

SmartMeter Names

SmartMeter Names

Get SmartMeter names

Get a list of SmartMeter names.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SmartMeter Details

SmartMeter configuration

Get Details

Get the details of the given SmartMeter.

Authorizations:
bearer
path Parameters
smartmeter
required
string

SmartMeter ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Algodue 1-phasig",
  • "description": "SmartMeter Server1",
  • "type": 314,
  • "type_name": "Algodue-UEM40-2C",
  • "meter_type": 0,
  • "uses_signed_integers": 1,
  • "modbus_read_function": "0x03",
  • "address": "2",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "rcm_address": "100",
  • "rcm_ac_assignment": "always-active",
  • "rcm_ac_max": 100,
  • "rcm_dc_assignment": "always-active",
  • "rcm_dc_max": 100,
  • "modbus_word_order": "big_endian",
  • "phases": [
    ],
  • "supplyline": "a"
}

Update configuration

Update the configuration of given SmartMeter.

Authorizations:
bearer
path Parameters
smartmeter
required
string

SmartMeter ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

device_id
integer

the ID of the device this device is assigned to

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

description
string

The description of the device

type
integer

The type of the device

type_name
string

The name of the type

meter_type
integer

Type for Energy efficiency measuring

uses_signed_integers
integer

Determines the prefix display

modbus_read_function
string
Enum: "0x03" "0x04"

The read-function for the modbus register

address
string

The address of the device

port
integer

The port of the device

group_id
integer

The ID of the group the device is assigned to

rack_id
integer

The ID of the rack the device is assigned to

rcm_address
string

The address of the RCM

rcm_ac_assignment
string
Enum: "off" "always-active" "armed-active" "fire" "sabotage" "display" "system"

The AC RCM alarm assignment

rcm_ac_max
integer or null

The max value for RCM AC

rcm_dc_assignment
string
Enum: "off" "always-active" "armed-active" "fire" "sabotage" "display" "system"

The DC RCM alarm assignment

rcm_dc_max
integer or null

The max value for RCM DC

modbus_word_order
string
Enum: "big_endian" "little_endian"

Word order settings

Array of objects
supplyline
string
Enum: "a" "b" "ab" "none" ""

The Supplyline assignment

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Algodue 1-phasig",
  • "description": "SmartMeter Server1",
  • "type": 314,
  • "type_name": "Algodue-UEM40-2C",
  • "meter_type": 0,
  • "uses_signed_integers": 1,
  • "modbus_read_function": "0x03",
  • "address": "2",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "rcm_address": "100",
  • "rcm_ac_assignment": "always-active",
  • "rcm_ac_max": 100,
  • "rcm_dc_assignment": "always-active",
  • "rcm_dc_max": 100,
  • "modbus_word_order": "big_endian",
  • "phases": [
    ],
  • "supplyline": "a"
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "device_id": 1,
  • "is_active": true,
  • "name": "Algodue 1-phasig",
  • "description": "SmartMeter Server1",
  • "type": 314,
  • "type_name": "Algodue-UEM40-2C",
  • "meter_type": 0,
  • "uses_signed_integers": 1,
  • "modbus_read_function": "0x03",
  • "address": "2",
  • "port": 502,
  • "group_id": 1,
  • "rack_id": null,
  • "rcm_address": "100",
  • "rcm_ac_assignment": "always-active",
  • "rcm_ac_max": 100,
  • "rcm_dc_assignment": "always-active",
  • "rcm_dc_max": 100,
  • "modbus_word_order": "big_endian",
  • "phases": [
    ],
  • "supplyline": "a"
}

SmartMeter Reset

SmartMeter Reset

Reset SmartMeter

Reset SmartMeter.

Authorizations:
bearer
path Parameters
smartmeter
required
string

SmartMeter ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

SNMP Settings

SNMP Settings

Get SNMP settings

Get a the system's SNMP settings

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "trapreceiver_active": true
}

Update SNMP settings

Update the system's SNMP settings

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

SNMP settings

is_active
boolean

Describes if the SNMP service is active

trapreceiver_active
boolean

Describe if the SNMP trap receiver is active

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "trapreceiver_active": true
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "trapreceiver_active": true
}

SNMP credential List

SNMP Hosts

SNMP credentials

Get a list of all SNMP credentials

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Create SNMP credential

Create a new SNMP credential

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

SNMP credential

id
integer

The ID of the SNMP credential

is_active
boolean

Describes if the SNMP credential is active

version
integer
Enum: 2 3

SNMP version of the credential. 2 = SNMPv2, 3 = SNMPv3

mode
integer
Enum: 1 2 3

Operating mode of the credential. 1 = Provide data, 2 = Send traps, 3 = Poll data

address
string or null

The IP address of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the address is the address trap receiver. If in mode "Poll Data" the address is the address of the device to poll.

port
integer or null

The port of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the port is the port of the trap receiver. If in mode "Poll Data" the port is the port of the device to poll.

name
string

The name of the SNMP credential

send_cold_start_trap
boolean

Describes if the device sends a cold start trap to the configured trap receiver.

send_warm_start_trap
boolean

Describes if the device sends a warm start trap to the configured trap receiver.

send_login_trap
boolean

Describes if the device sends a login trap to the configured trap receiver.

send_alarm_trap
boolean

Describes if the device sends an alarm trap to the configured trap receiver.

send_structured_alarm_trap
boolean

Describes if the device sends a structured alarm trap to the configured trap receiver.

send_alarm_state_change_trap
boolean

Describes if the device sends an alarm state change trap to the configured trap receiver.

send_access_trap
boolean

Describes if the device sends an access trap to the configured trap receiver.

send_structured_access_trap
boolean

Describes if the device sends a structured access trap to the configured trap receiver.

username
string or null

The username of the SNMP credential. Only required for SNMPv3.

community
string or null

The community of the SNMP credential. Only required for SNMPv2.

authentication_protocol
integer or null
Enum: 1 2 3

The authentication protocol of the SNMP credential. Only required for SNMPv3. 1 = No authentication, 2 = HMAC-MD5, 3 = HMAC-SHA

authentication_password
string or null

The authentication password of the SNMP credential. Only required for SNMPv3.

privacy_protocol
integer or null
Enum: 1 2 3 4 9 20 21 22 23 24

The privacy protocol of the SNMP credential. Only required for SNMPv3. 1 = No privacy protocol, 2 = DES, 3 = 3DES, 4 = AES128, 9 = IDEA, 20 = AES192, 21 = AES256, 22 = AES128 3DES, 23 = AES192 3DES, 24 = AES256 3DES

privacy_password
string or null

The privacy password of the SNMP credential. Only required for SNMPv3.

heartbeat_interval
integer or null

The heartbeat interval of the SNMP credential. Only required for mode "Poll Data".

Responses

Request samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "mode": 1,
  • "address": "192.168.100.222",
  • "port": 161,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "username": "myuser",
  • "community": "public",
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": null,
  • "heartbeat_interval": 60
}

Response samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "mode": 1,
  • "address": "192.168.100.222",
  • "port": 161,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "username": "myuser",
  • "community": "public",
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": null,
  • "heartbeat_interval": 60
}

Delete SNMP credentials

Delete multiple SNMP credentials

Request Body schema: application/json
required

SNMP credential IDs to delete

Array
integer

Responses

Request samples

Content type
application/json
[
  • 0
]

SNMP credential names

SNMP Host Names

SNMP credential names

Get a shortened list of all SNMP credentials

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Test SNMP credential

SNMP Host Test

Test SNMP credential

Test SNMP credential settings

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Test SNMP credential settings

id
integer

The ID of the SNMP credential

is_active
boolean

Describes if the SNMP credential is active

version
integer
Enum: 2 3

SNMP version of the credential. 2 = SNMPv2, 3 = SNMPv3

name
string

The name of the SNMP credential

send_cold_start_trap
boolean

Describes if the device sends a cold start trap to the configured trap receiver.

send_warm_start_trap
boolean

Describes if the device sends a warm start trap to the configured trap receiver.

send_login_trap
boolean

Describes if the device sends a login trap to the configured trap receiver.

send_alarm_trap
boolean

Describes if the device sends an alarm trap to the configured trap receiver.

send_structured_alarm_trap
boolean

Describes if the device sends a structured alarm trap to the configured trap receiver.

send_alarm_state_change_trap
boolean

Describes if the device sends an alarm state change trap to the configured trap receiver.

send_access_trap
boolean

Describes if the device sends an access trap to the configured trap receiver.

send_structured_access_trap
boolean

Describes if the device sends a structured access trap to the configured trap receiver.

community
string

The community name of the SNMP credential. Only required for SNMPv2.

username
string

The username of the SNMP credential. Only required for SNMPv3.

mode
integer
Enum: 1 2 3

Operating mode of the credential. 1 = Provide data, 2 = Send traps, 3 = Poll data

address
string or null

The IP address of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the address is the address trap receiver. If in mode "Poll Data" the address is the address of the device to poll.

port
integer or null

The port of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the port is the port of the trap receiver. If in mode "Poll Data" the port is the port of the device to poll.

authentication_protocol
integer or null
Enum: 1 2 3

The authentication protocol of the SNMP credential. Only required for SNMPv3. 1 = No authentication, 2 = HMAC-MD5, 3 = HMAC-SHA

authentication_password
string or null

The authentication password of the SNMP credential. Only required for SNMPv3.

privacy_protocol
integer or null
Enum: 1 2 3 4 9 20 21 22 23 24

The privacy protocol of the SNMP credential. Only required for SNMPv3. 1 = No privacy protocol, 2 = DES, 3 = 3DES, 4 = AES128, 9 = IDEA, 20 = AES192, 21 = AES256, 22 = AES128 3DES, 23 = AES192 3DES, 24 = AES256 3DES

privacy_password
string or null

The privacy password of the SNMP credential. Only required for SNMPv3.

Responses

Request samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "community": "public",
  • "username": "myuser",
  • "mode": 1,
  • "address": "192.168.100.100",
  • "port": 161,
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": "myPrivPassword"
}

SNMP credential Details

Specific SNMP Host

SNMP credential

Get a specific SNMP credential by ID

path Parameters
host_id
required
integer

SNMP credential ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "mode": 1,
  • "address": "192.168.100.222",
  • "port": 161,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "username": "myuser",
  • "community": "public",
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": null,
  • "heartbeat_interval": 60
}

Update SNMP credential

Update a specific SNMP credential by ID

path Parameters
host_id
required
integer

SNMP credential ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

SNMP credential

id
integer

The ID of the SNMP credential

is_active
boolean

Describes if the SNMP credential is active

version
integer
Enum: 2 3

SNMP version of the credential. 2 = SNMPv2, 3 = SNMPv3

mode
integer
Enum: 1 2 3

Operating mode of the credential. 1 = Provide data, 2 = Send traps, 3 = Poll data

address
string or null

The IP address of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the address is the address trap receiver. If in mode "Poll Data" the address is the address of the device to poll.

port
integer or null

The port of the SNMP credential. Only required for mode "Send traps" and "Poll Data". If in mode "Send traps" the port is the port of the trap receiver. If in mode "Poll Data" the port is the port of the device to poll.

name
string

The name of the SNMP credential

send_cold_start_trap
boolean

Describes if the device sends a cold start trap to the configured trap receiver.

send_warm_start_trap
boolean

Describes if the device sends a warm start trap to the configured trap receiver.

send_login_trap
boolean

Describes if the device sends a login trap to the configured trap receiver.

send_alarm_trap
boolean

Describes if the device sends an alarm trap to the configured trap receiver.

send_structured_alarm_trap
boolean

Describes if the device sends a structured alarm trap to the configured trap receiver.

send_alarm_state_change_trap
boolean

Describes if the device sends an alarm state change trap to the configured trap receiver.

send_access_trap
boolean

Describes if the device sends an access trap to the configured trap receiver.

send_structured_access_trap
boolean

Describes if the device sends a structured access trap to the configured trap receiver.

username
string or null

The username of the SNMP credential. Only required for SNMPv3.

community
string or null

The community of the SNMP credential. Only required for SNMPv2.

authentication_protocol
integer or null
Enum: 1 2 3

The authentication protocol of the SNMP credential. Only required for SNMPv3. 1 = No authentication, 2 = HMAC-MD5, 3 = HMAC-SHA

authentication_password
string or null

The authentication password of the SNMP credential. Only required for SNMPv3.

privacy_protocol
integer or null
Enum: 1 2 3 4 9 20 21 22 23 24

The privacy protocol of the SNMP credential. Only required for SNMPv3. 1 = No privacy protocol, 2 = DES, 3 = 3DES, 4 = AES128, 9 = IDEA, 20 = AES192, 21 = AES256, 22 = AES128 3DES, 23 = AES192 3DES, 24 = AES256 3DES

privacy_password
string or null

The privacy password of the SNMP credential. Only required for SNMPv3.

heartbeat_interval
integer or null

The heartbeat interval of the SNMP credential. Only required for mode "Poll Data".

Responses

Request samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "mode": 1,
  • "address": "192.168.100.222",
  • "port": 161,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "username": "myuser",
  • "community": "public",
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": null,
  • "heartbeat_interval": 60
}

Response samples

Content type
application/json
{
  • "id": 5,
  • "is_active": true,
  • "version": 2,
  • "mode": 1,
  • "address": "192.168.100.222",
  • "port": 161,
  • "name": "My SNMP data provider",
  • "send_cold_start_trap": false,
  • "send_warm_start_trap": false,
  • "send_login_trap": false,
  • "send_alarm_trap": false,
  • "send_structured_alarm_trap": false,
  • "send_alarm_state_change_trap": false,
  • "send_access_trap": false,
  • "send_structured_access_trap": false,
  • "username": "myuser",
  • "community": "public",
  • "authentication_protocol": 1,
  • "authentication_password": null,
  • "privacy_protocol": 1,
  • "privacy_password": null,
  • "heartbeat_interval": 60
}

Delete SNMP credential

Delete a specific SNMP credential by ID

path Parameters
host_id
required
integer

SNMP credential ID

Responses

Disable SNMP credentials

Disable multiple SNMP Hosts

Disable SNMP credentials

Disable multiple SNMP credentials

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

SNMP credential IDs to disable

Array
integer

SNMP credential ID

Responses

Request samples

Content type
application/json
[
  • 0
]

Enable SNMP credentials

Enable multiple SNMP Hosts

Enable SNMP credentials

Enable multiple SNMP credentials

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

SNMP credential IDs to enable

Array
integer

SNMP credential ID

Responses

Request samples

Content type
application/json
[
  • 0
]

SNMP-Sensor List

SNMP-Sensors

Get SNMP-Sensor

Get a list of all SNMP-Sensor.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

SNMP-Sensor Names

SNMP-Sensor Names

Get SNMP-Sensor names

Get the names of all SNMP-Sensors.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SNMP-Sensor Details

Configuration of the SNMP-Sensor

Get Details

Get the configuration of given SNMP-Sensor.

Authorizations:
bearer
path Parameters
sensor
required
string

SNMP-Sensor ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "snmp_oid": ".1.1.1.1.1.1.1.1.1.1.1.1.1.1",
  • "snmp_credential_id": 1,
  • "alarmdelay": 10,
  • "sendcycle": 60,
  • "settings": {
    },
  • "snmp_connection_assignment": null,
  • "webhooks": [
    ]
}

Update configuration

Update the configuration of given SNMP-Sensor.

Authorizations:
bearer
path Parameters
sensor
required
string

SNMP-Sensor ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

id
integer

the ID of the device

is_active
boolean

The flag to determine the status of the device

name
string

The name of the device

description
string

The description of the device

snmp_oid
string

The OID this sensor refers to

snmp_credential_id
integer

The ID of the SNMP-Credential used

alarmdelay
integer

The amount of seconds an alarm will be delayed

sendcycle
integer

The interval for requesting data (in seconds)

object
snmp_connection_assignment
integer

[DEPRECATED] unused property

webhooks
Array of arrays

The webhook relations of this device

Responses

Request samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "snmp_oid": ".1.1.1.1.1.1.1.1.1.1.1.1.1.1",
  • "snmp_credential_id": 1,
  • "alarmdelay": 10,
  • "sendcycle": 60,
  • "settings": {
    },
  • "snmp_connection_assignment": null,
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 2,
  • "is_active": true,
  • "name": "MultiSensor",
  • "description": "MultiSensor main hall",
  • "snmp_oid": ".1.1.1.1.1.1.1.1.1.1.1.1.1.1",
  • "snmp_credential_id": 1,
  • "alarmdelay": 10,
  • "sendcycle": 60,
  • "settings": {
    },
  • "snmp_connection_assignment": null,
  • "webhooks": [
    ]
}

System-Events

System-Event List

Get System-Events

Get a list of System-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

System-Event Export

System-Event Export

Export System-Events

Export all System-Events.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

System name

System name

Get system name

Gets the system name.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update system name

Updates the system name.

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

The name of the system.

Responses

Request samples

Content type
application/json
{
  • "name": "My AlarmManager"
}

Response samples

Content type
application/json
{
  • "name": "My AlarmManager"
}

Systemanalysis

Systemanalysis

Get Status

Get the status of the Systemanalysis.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "state": 0,
  • "message": "OK"
}

Toggle analysis

Start/ stop the systemanalysis.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json

Successful operation

action
string
Enum: "start" "stop"

Action to start/ stop the systemanalysis

timeout
integer

The length of the operation in minutes

pack_settings
boolean

Determine if the settings database shall be analyzed as well

Responses

Request samples

Content type
application/json
{
  • "action": "start",
  • "timeout": 5,
  • "pack_settings": true
}

Response samples

Content type
application/json
{
  • "state": 0,
  • "message": "OK"
}

Systemanalysis Report

Systemanalysis Report

Get Report

Get the report of the Systemanalysis.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Table View List

Table View List

Get the table views

Get Table Views.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add a new table view

Add table view.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Successful operation

name
string

The name of the table view

Array of objects
is_global
boolean

If true the table view will be shown to all users

is_default
boolean

If true the table view will be set as default

Responses

Request samples

Content type
application/json
{
  • "name": "DoorLocks",
  • "tables": [
    ],
  • "is_global": true,
  • "is_default": true
}

Response samples

Content type
application/json
[
  • {
    }
]

Table View

Table View Details

Get the details of given table view

Get Table View Details.

Authorizations:
bearer
path Parameters
tableview
required
string

Table View ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "user_id": 1,
  • "name": "DoorLocks",
  • "tables": [
    ],
  • "is_global": true,
  • "is_default": true
}

Update a new table view

Update table view.

Authorizations:
bearer
path Parameters
tableview
required
string

Table View ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Successful operation

name
string

The name of the table view

Array of objects
is_global
boolean

If true the table view will be shown to all users

is_default
boolean

If true the table view will be set as default

Responses

Request samples

Content type
application/json
{
  • "name": "DoorLocks",
  • "tables": [
    ],
  • "is_global": true,
  • "is_default": true
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete table view

Delete table view.

Authorizations:
bearer
path Parameters
tableview
required
string

Table View ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Add device

Add device

Start to add device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Request payload to add a new device

One of
Array of objects

Responses

Request samples

Content type
application/json
Example
{
  • "devices": [
    ]
}

Response samples

Content type
application/json
{
  • "devices": [
    ],
  • "racks": [
    ],
  • "uuid": "3e2e7ee8-16ab-472b-9529-1d246b9e8d26"
}

Get processing state of device adding

Get processing state of device adding.

Authorizations:
bearer
path Parameters
teachin_uuid
required
string

Identifier of the adding process

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "devices": [
    ],
  • "racks": [
    ],
  • "uuid": "3e2e7ee8-16ab-472b-9529-1d246b9e8d26"
}

Finish or abort device adding process

Finish or abort device adding process

Authorizations:
bearer
path Parameters
teachin_uuid
required
string

Identifier of the adding process

header Parameters
Accept
required
string
Value: "application/json"

Responses

Remove device

Remove devices or racks

Start to remove devices or racks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Request payload for device or rack removal

devices
Array of numbers

List of device id's which should be removed

racks
Array of numbers

List of rack id's which should be removed

Responses

Request samples

Content type
application/json
{
  • "devices": [
    ],
  • "racks": [
    ]
}

Response samples

Content type
application/json
{
  • "devices": [
    ],
  • "racks": [
    ],
  • "uuid": "3e2e7ee8-16ab-472b-9529-1d246b9e8d26"
}

Get processing state of device removal

Get processing state of device removal.

Authorizations:
bearer
path Parameters
teachout_uuid
required
string

Identifier of the removal process

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "devices": [
    ],
  • "racks": [
    ],
  • "uuid": "3e2e7ee8-16ab-472b-9529-1d246b9e8d26"
}

Thermal-Image Settings

Thermal-Image Settings

Get TI-Settings

Get the TI-Settings of given device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "color_mode": "gray",
  • "rotation": 90,
  • "custom_range": true,
  • "min_value": 1000,
  • "max_value": 2100,
  • "ir_emissivity": "0.94999999999999996",
  • "distance": 250,
  • "temperature_offset": 2,
  • "fov": {
    }
}

Remote Thermal-Image Settings

Remote Thermal-Image Settings

Get Remote TI-Settings

Get the TI-Settings of given device from remote.

Authorizations:
bearer
path Parameters
multisensor_id
required
integer

ID of the multisensor

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "color_mode": "gray",
  • "rotation": 90,
  • "custom_range": true,
  • "min_value": 1000,
  • "max_value": 2100,
  • "ir_emissivity": "0.94999999999999996",
  • "distance": 250,
  • "temperature_offset": 2,
  • "fov": {
    }
}

Thermal-Image Exclusion-Areas

Thermal-Image Exclusion-Areas

Get TI-Data

Get the TI-Data of given device.

Authorizations:
bearer
path Parameters
multisensor_id
required
integer

ID of the multisensor

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Remote Thermal-Image Exclusion-Areas

Remote Thermal-Image Exclusion-Areas

Get Remote TI-Data

Get the Remote TI-Data of given device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Thermal-Image Data

Thermal-Image Data

Get TI-Data

Get the TI-Data of given device.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "area_length": 1856,
  • "area_width": 1856,
  • "events": [
    ],
  • "height": 32,
  • "width": 32,
  • "max": {
    },
  • "min_value": 1285,
  • "padding": {
    },
  • "pixel_length": 58,
  • "pixel_width": 58,
  • "seq": 304,
  • "ts": 1678092024,
  • "values": [
    ]
}

Remote Thermal-Image Data

Remote Thermal-Image Data

Get Remote TI-Data

Get the TI-Data of given device from remote.

Authorizations:
bearer
path Parameters
multisensor_id
required
integer

ID of the multisensor

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "area_length": 1856,
  • "area_width": 1856,
  • "events": [
    ],
  • "height": 32,
  • "width": 32,
  • "max": {
    },
  • "min_value": 1285,
  • "padding": {
    },
  • "pixel_length": 58,
  • "pixel_width": 58,
  • "seq": 304,
  • "ts": 1678092024,
  • "values": [
    ]
}

Eventprofile List

Eventprofiles

Get Eventprofiles

Get a list of Eventprofiles.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[]

Add Eventprofile

Add new Eventprofile.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Eventprofile Data

blockingprofiles
Array of integers

The related blockingprofiles

groups
Array of integers

The groups this eventprofile applies to

id
integer

The ID of the eventprofile (if not given, a new eventprofile with the given data will be added)

name
string

The name of the eventprofile

outputs
Array of integers

The outputs this eventprofile applies to

type
string
Enum: "group" "output"

The type of the eventprofile

Array of objects

The Events related to this eventprofile

Responses

Request samples

Content type
application/json
{
  • "blockingprofiles": [
    ],
  • "groups": [
    ],
  • "id": 1,
  • "name": "Example",
  • "outputs": [ ],
  • "type": "group",
  • "eventtimes": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Mass-delete Eventprofiles

Delete all given Eventprofiles.

Authorizations:
bearer
Request Body schema: application/json

Mass-Delete eventprofiles

events
Array of integers

The ids of the eventprofiles to be deleted

Responses

Request samples

Content type
application/json
{
  • "events": [
    ]
}

Eventprofile Details

Eventprofile configuration

Get Details

Get the configuration of given Eventprofile.

Authorizations:
bearer
path Parameters
event
required
string

Eventprofile ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update configuration

Update the configuration of given MultiSensor.

Authorizations:
bearer
path Parameters
event
required
string

Eventprofile ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Eventprofile Data

blockingprofiles
Array of integers

The related blockingprofiles

groups
Array of integers

The groups this eventprofile applies to

id
integer

The ID of the eventprofile (if not given, a new eventprofile with the given data will be added)

name
string

The name of the eventprofile

outputs
Array of integers

The outputs this eventprofile applies to

type
string
Enum: "group" "output"

The type of the eventprofile

Array of objects

The Events related to this eventprofile

Responses

Request samples

Content type
application/json
{
  • "blockingprofiles": [
    ],
  • "groups": [
    ],
  • "id": 1,
  • "name": "Example",
  • "outputs": [ ],
  • "type": "group",
  • "eventtimes": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete Eventprofile

Delete given Eventprofile.

Authorizations:
bearer
path Parameters
event
required
string

Eventprofile ID

Responses

Timeprofile List

Get timeprofiles

Get all timeprofiles

Requests all timeprofiles which the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Create timeprofile

Creates a new timeprofile.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Timeprofile configuration to be added

id
integer

Id of timeprofile name

created_at
string

ISO 8601 Timestamp when the timeprofile was created

updated_at
string

ISO 8601 Timestamp when the timeprofile was updated

name
string

Name of the timeprofile

flagstring
string

ISO 8601 Timestamp when the timeprofile was updated

exceptionday_profile_id
number

Select an exception day profile for this timeprofile. On the given days of this profile, the timeprofile will not be active.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "created_at": "2022-03-31T09:28:25+02:00",
  • "updated_at": "2022-03-31T16:09:08+02:00",
  • "name": "Timeprofile",
  • "flagstring": "0000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF00000000000000000000000000000000000000000000000000000",
  • "exceptionday_profile_id": 1
}

Response samples

Content type
application/json
[
  • {
    }
]

Timeprofile Details

Get a specific timeprofile by a Id

Get timeprofile by ID

Requests the timeprofile via its ID.

Authorizations:
bearer
path Parameters
timeprofile_id
required
string

ID of the timeprofile to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update timeprofile by ID

Updates the configuration of a specific timeprofile. Validation errors are returned in the response body with HTTP 422.

Authorizations:
bearer
path Parameters
timeprofile_id
required
string

ID of the timeprofile to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

Timeprofile configuration to be updated

id
integer

Id of timeprofile name

created_at
string

ISO 8601 Timestamp when the timeprofile was created

updated_at
string

ISO 8601 Timestamp when the timeprofile was updated

name
string

Name of the timeprofile

flagstring
string

ISO 8601 Timestamp when the timeprofile was updated

exceptionday_profile_id
number

Select an exception day profile for this timeprofile. On the given days of this profile, the timeprofile will not be active.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "created_at": "2022-03-31T09:28:25+02:00",
  • "updated_at": "2022-03-31T16:09:08+02:00",
  • "name": "Timeprofile",
  • "flagstring": "0000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF000000000000FFFFFFFFFFFF00000000000000000000000000000000000000000000000000000",
  • "exceptionday_profile_id": 1
}

Response samples

Content type
application/json
[
  • {
    }
]

Timeprofile Names

Get timeprofiles

Timeprofiles names

Requests a list of all timeprofiles the user has access to.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Software Update

Software Update

Get update status

Gets the update status.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "Update finished",
  • "status": {
    }
}

Perform Update

Starts the update process with the given file.

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
required

The update file to upload.

string <binary>

Responses

Request samples

Content type
application/json
"string"

Response samples

Content type
application/json
{
  • "status": true
}

OTA-Update

Contains requests regarding an OTA update of the local device.

Get update status

Gets the update status.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "date": "2023-02-20",
  • "device_type": 8,
  • "os_revision": 2,
  • "releasenotes": "<ul>\n<li>Test</li></ul>",
  • "version": "08.01.03 B00950"
}

Perform OTA-Update

Starts the update process.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Update State

Get general information on the current update state of the system.

Get update state

Get all information regarding the current update state of the system.

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "info": {
    },
  • "ota": {
    },
  • "upload": {
    },
  • "update": {
    }
}

Usergroup Names

Get Usergroup names

Requests all Usergroups.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Usergroups

Get Usergroups

Get all Usergroups.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Add Usergroup

Add a new Usergroup.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Describes the name of the Usergroup. Must be unique.

object

Describes the permissions the Usergroup have.

Responses

Request samples

Content type
application/json
{
  • "name": "Manager",
  • "permissions": {
    }
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Manager",
  • "created_at": "2023-01-05T16:24:46.000000Z",
  • "updated_at": "2023-01-07T16:30:28.000000Z",
  • "permissions": {
    }
}

Delete Usergroups

Mass delete Usergroups.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
usergroups
Array of integers

Responses

Request samples

Content type
application/json
{
  • "usergroups": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Usergroup

Get Usergroup

Get a specific Usergroup via its ID.

Authorizations:
bearer
path Parameters
usergroup_id
required
string

ID of the Usergroup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update Usergroup

Update a specific Usergroup via its ID.

Authorizations:
bearer
path Parameters
usergroup_id
required
string

ID of the Usergroup to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Describes the name of the Usergroup. Must be unique.

object

Describes the permissions the Usergroup have.

Responses

Request samples

Content type
application/json
{
  • "name": "Manager",
  • "permissions": {
    }
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Manager",
  • "created_at": "2023-01-05T16:24:46.000000Z",
  • "updated_at": "2023-01-07T16:30:28.000000Z",
  • "permissions": {
    }
}

Delete Usergroup

Delete a specific Usergroup via its ID.

Authorizations:
bearer
path Parameters
usergroup_id
required
string

ID of the Usergroup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Webhook Names

Get Webhook names

Requests all Webhooks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Webhooks

Get Webhooks

Get all Webhooks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Add Webhook

Add a new Webhook.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Describes the name of the Webhook.

is_active
boolean

Describes if the Webhook is en-/disabled.

request_type
integer [ 0 .. 3 ]

HTTP-Method for the request.
0 => POST
1 => GET
2 => PATCH
3 => DELETE

content_type
integer [ 0 .. 2 ]

Content-Type of the data.
0 => text/plain
1 => application/json
2 => application/xml

url
string <URL>

URL used for the request.
ATTENTION: Some parameters have to be encoded. For further information, please check the Webhook documentation.

data
string or null

Data which should be send.

authentication_mode
integer [ 0 .. 2 ]

Authentication for the request.
0 => No Authentication
1 => Basic Auth
2 => Bearer Token

username
string or null

When Authentication:
- Basic Auth => Describes username
- Bearer Token => Describes token

password
string or null

Describes the password for Basic Auth.

Responses

Request samples

Content type
application/json
{
  • "name": "Invoice",
  • "is_active": true,
  • "request_type": 0,
  • "content_type": 0,
  • "url": "https://192.168.0.1/",
  • "data": "Message from my Kentix device.",
  • "authentication_mode": 0,
  • "username": "root",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Invoice",
  • "created_at": "2023-01-05T16:24:46.000000Z",
  • "updated_at": "2023-01-07T16:30:28.000000Z",
  • "is_active": true,
  • "request_type": 0,
  • "content_type": 0,
  • "url": "https://192.168.0.1/",
  • "data": "Message from my Kentix device.",
  • "authentication_mode": 0,
  • "username": "root",
  • "password": "password"
}

Delete Webhooks

Mass delete Webhooks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
webhooks
Array of integers

Responses

Request samples

Content type
application/json
{
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Webhook Test result

Get result of the last webhook configuration test.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "has_response": false,
  • "response_code": -1
}

Webhook

Get Webhook

Get a specific Webhook via its ID.

Authorizations:
bearer
path Parameters
webhook_id
required
string

ID of the Webhook to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update Webhook

Update a specific Webhook via its ID.

Authorizations:
bearer
path Parameters
webhook_id
required
string

ID of the Webhook to be queried

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
name
string

Describes the name of the Webhook.

is_active
boolean

Describes if the Webhook is en-/disabled.

request_type
integer [ 0 .. 3 ]

HTTP-Method for the request.
0 => POST
1 => GET
2 => PATCH
3 => DELETE

content_type
integer [ 0 .. 2 ]

Content-Type of the data.
0 => text/plain
1 => application/json
2 => application/xml

url
string <URL>

URL used for the request.
ATTENTION: Some parameters have to be encoded. For further information, please check the Webhook documentation.

data
string or null

Data which should be send.

authentication_mode
integer [ 0 .. 2 ]

Authentication for the request.
0 => No Authentication
1 => Basic Auth
2 => Bearer Token

username
string or null

When Authentication:
- Basic Auth => Describes username
- Bearer Token => Describes token

password
string or null

Describes the password for Basic Auth.

Responses

Request samples

Content type
application/json
{
  • "name": "Invoice",
  • "is_active": true,
  • "request_type": 0,
  • "content_type": 0,
  • "url": "https://192.168.0.1/",
  • "data": "Message from my Kentix device.",
  • "authentication_mode": 0,
  • "username": "root",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Invoice",
  • "created_at": "2023-01-05T16:24:46.000000Z",
  • "updated_at": "2023-01-07T16:30:28.000000Z",
  • "is_active": true,
  • "request_type": 0,
  • "content_type": 0,
  • "url": "https://192.168.0.1/",
  • "data": "Message from my Kentix device.",
  • "authentication_mode": 0,
  • "username": "root",
  • "password": "password"
}

Delete Usergroup

Delete a specific Usergroup via its ID.

Authorizations:
bearer
path Parameters
webhook_id
required
string

ID of the Usergroup to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

En-/Disable Webhooks

Disable Webhooks

Disable multiple Webhooks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
webhooks
Array of integers

Responses

Request samples

Content type
application/json
{
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Enable Webhooks

Enable multiple Webhooks.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
webhooks
Array of integers

Responses

Request samples

Content type
application/json
{
  • "webhooks": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Test Webhook Configuration

Test Webhook

Test the configuration of a Webhook.

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

Id of an existing webhook.

request_type
integer [ 0 .. 3 ]

HTTP-Method for the request.
0 => POST
1 => GET
2 => PATCH
3 => DELETE

content_type
integer [ 0 .. 2 ]

Content-Type of the data.
0 => text/plain
1 => application/json
2 => application/xml

url
string <URL>

URL used for the request.
ATTENTION: Some parameters have to be encoded. For further information, please check the Webhook documentation.

data
string or null

Data which should be send.

authentication_mode
integer [ 0 .. 2 ]

Authentication for the request.
0 => No Authentication
1 => Basic Auth
2 => Bearer Token

username
string or null

When Authentication:
- Basic Auth => Describes username
- Bearer Token => Describes token

password
string or null

Describes the password for Basic Auth.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "request_type": 0,
  • "content_type": 0,
  • "url": "https://192.168.0.1/",
  • "data": "Message from my Kentix device.",
  • "authentication_mode": 0,
  • "username": "root",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

User List

User management

Get all users

Get a shortened list of all users

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{}

Create user

Create a new user

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
username
required
string

Distinct username of this user

password
string

The current user's password, needed to log into the webinterface.

password_confirmation
string

Password confirmation field

is_active
boolean

Describes if the current userprofile is active

unlock_at
string or null

Date when the user will be automatically nlocked

lock_at
string or null

Date when the user will be automatically locked

autologout
integer or null
Enum: 5 15 30 60 120 360 720

The time in minutes for auto logout or null to disable it.

fullname
string

Full name of the user

email
string or null

Email address of the user

phone
string or null

Cellphone number of the user

description
string or null

Optional description text

is_admin
boolean

Describes if the user is an administrator

object
rfid_uid
string

RFID UID of the user. If set, the user can be identified by RFID. The RFID UID is a 32 character hex string. The RFID UID can be set to null to disable RFID authentication.

Array of objects

List of levelprofiles that are assigned to the user. The user will have the permissions of the levelprofiles.

pin
string

PIN code of the user. If set, the user can be identified by PIN. The PIN code can be set to null to disable PIN authentication.

emergency_access
boolean

Describes if the user has emergency access, if the assigned doorlocks are offline.

armdisarm_mode
integer [ 0 .. 2 ]

Describes if the user may arm/disarm an alarmsystem. 0: User can not arm/disarm an alarmsystem. 1: User only can disarm an alarmsystem. 2: User can arm and disarm an alarmsystem.

alarmgroups
Array of integers

List of alarmgroups that are assigned to the user. The user will receive alarms from the alarmgroups and can see all devices within the alarmgroups.

usergroup_id
integer

ID of the usergroup that is assigned to the user.

uses_cloud
boolean

Describes if the user has access to the KentixONE cloud. If true, the user can login to the KentixONE cloud via the app.

invoicegroups
Array of integers

List of invoicegroups that are assigned to the user. The user will receive invoice reports from the invoicegroups.

rfid_data
any

RFID data of the user.

Responses

Request samples

Content type
application/json
{
  • "username": "admin",
  • "password": "string",
  • "password_confirmation": "string",
  • "is_active": true,
  • "unlock_at": "2022-03-31T07:29:20.000000Z",
  • "lock_at": "2022-04-30T07:30:00.000000Z",
  • "autologout": 120,
  • "fullname": "Administrator",
  • "email": "a.dministrator@example.com",
  • "phone": "+49123456789",
  • "description": "A very cool admin",
  • "is_admin": false,
  • "notification_channels": {
    },
  • "rfid_uid": 0,
  • "levelprofiles": [
    ],
  • "pin": "1234",
  • "emergency_access": true,
  • "armdisarm_mode": 0,
  • "alarmgroups": [
    ],
  • "usergroup_id": 1,
  • "uses_cloud": false,
  • "invoicegroups": [ ],
  • "rfid_data": null
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "username": "admin",
  • "is_active": true,
  • "unlock_at": "2022-03-31T07:29:20.000000Z",
  • "lock_at": "2022-04-30T07:30:00.000000Z",
  • "autologout": 120,
  • "fullname": "Administrator",
  • "email": "a.dministrator@example.com",
  • "phone": "+49123456789",
  • "description": "A very cool admin",
  • "is_admin": false,
  • "api_token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  • "notification_channels": {
    },
  • "rfid_uid": 0,
  • "levelprofiles": [
    ],
  • "pin": "1234",
  • "emergency_access": true,
  • "armdisarm_mode": 0,
  • "alarmgroups": [
    ],
  • "usergroup_id": 1,
  • "uses_cloud": false,
  • "invoicegroups": [ ],
  • "rfid_data": null
}

Mass-Delete users

Delete multiple users

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

User Details

User management

Get user

Get a specific user by ID

Authorizations:
bearer
path Parameters
user_id
required
string

User ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "username": "admin",
  • "is_active": true,
  • "unlock_at": "2022-03-31T07:29:20.000000Z",
  • "lock_at": "2022-04-30T07:30:00.000000Z",
  • "autologout": 120,
  • "fullname": "Administrator",
  • "email": "a.dministrator@example.com",
  • "phone": "+49123456789",
  • "description": "A very cool admin",
  • "is_admin": false,
  • "api_token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  • "notification_channels": {
    },
  • "rfid_uid": 0,
  • "levelprofiles": [
    ],
  • "pin": "1234",
  • "emergency_access": true,
  • "armdisarm_mode": 0,
  • "alarmgroups": [
    ],
  • "usergroup_id": 1,
  • "uses_cloud": false,
  • "invoicegroups": [ ],
  • "rfid_data": null
}

Update user

Update a user

Authorizations:
bearer
path Parameters
user_id
required
string

User ID

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

The current user's id

username
string

Distinct username of this user

password
string

The current user's password

password_confirmation
string

Password confirmation field

is_active
boolean

Describes if the current userprofile is active

unlock_at
string or null

Date when the user will be automatically unlocked

lock_at
string or null

Date when the user will be automatically locked

autologout
integer or null
Enum: 5 15 30 60 120 360 720

The time in minutes for auto logout or null to disable it.

fullname
string

Full name of the user

email
string or null

Email address of the user

phone
string or null

Cellphone number of the user

description
string or null

Optional description text

is_admin
boolean

Describes if the user is an administrator

object

Notification channels for the user. The user will receive notifications for the selected alarms. Channels not marked as required may not be present on all devices.

rfid_uid
string

RFID UID of the use. If set, the user can be identified by RFID. The RFID UID is a 32 character hex string. The RFID UID can be set to null to disable RFID authentication.

Array of objects

List of levelprofiles that are assigned to the user. The user will have the permissions of the levelprofiles.

pin
string

PIN code of the user. If set, the user can be identified by PIN. The PIN code can be set to null to disable PIN authentication.

emergency_access
boolean

Describes if the user has emergency access, if the assigned doorlocks are offline.

armdisarm_mode
integer [ 0 .. 2 ]

Describes if the user may arm/disarm an alarmsystem. 0: User can not arm/disarm an alarmsystem. 1: User only can disarm an alarmsystem. 2: User can arm and disarm an alarmsystem.

alarmgroups
Array of integers

List of alarmgroups that are assigned to the user. The user will receive alarms from the alarmgroups and can see all devices within the alarmgroups.

usergroup_id
integer

ID of the usergroup that is assigned to the user.

uses_cloud
boolean

Describes if the user has access to the KentixONE cloud. If true, the user can login to the KentixONE cloud via the app.

invoicegroups
Array of integers

List of invoicegroups that are assigned to the user. The user will receive invoice reports from the invoicegroups.

rfid_data
any

RFID data of the user.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "username": "admin",
  • "password": "string",
  • "password_confirmation": "string",
  • "is_active": true,
  • "unlock_at": "2022-03-31T07:29:20.000000Z",
  • "lock_at": "2022-04-30T07:30:00.000000Z",
  • "autologout": 120,
  • "fullname": "Administrator",
  • "email": "a.dministrator@example.com",
  • "phone": "+49123456789",
  • "description": "A very cool admin",
  • "is_admin": false,
  • "notification_channels": {
    },
  • "rfid_uid": 0,
  • "levelprofiles": [
    ],
  • "pin": "1234",
  • "emergency_access": true,
  • "armdisarm_mode": 0,
  • "alarmgroups": [
    ],
  • "usergroup_id": 1,
  • "uses_cloud": false,
  • "invoicegroups": [ ],
  • "rfid_data": null
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "username": "admin",
  • "is_active": true,
  • "unlock_at": "2022-03-31T07:29:20.000000Z",
  • "lock_at": "2022-04-30T07:30:00.000000Z",
  • "autologout": 120,
  • "fullname": "Administrator",
  • "email": "a.dministrator@example.com",
  • "phone": "+49123456789",
  • "description": "A very cool admin",
  • "is_admin": false,
  • "api_token": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  • "notification_channels": {
    },
  • "rfid_uid": 0,
  • "levelprofiles": [
    ],
  • "pin": "1234",
  • "emergency_access": true,
  • "armdisarm_mode": 0,
  • "alarmgroups": [
    ],
  • "usergroup_id": 1,
  • "uses_cloud": false,
  • "invoicegroups": [ ],
  • "rfid_data": null
}

Delete user

Delete a user

Authorizations:
bearer
path Parameters
user_id
required
string

User ID

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Disable multiple users

User management

Mass-Disable users

Disable multiple users

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Enable multiple users

User management

Mass-Enable users

(Re-)Enable multiple users

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Edit multiple users

User Massedit

Update multiple users

Updates a list of users with the data given per user

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "users": {
    }
}

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Get multiple users

Get a list of multiple users

Authorizations:
bearer
header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
Array
integer

The ids of the users of whom you want to fetch data

Responses

Request samples

Content type
application/json
[
  • 1
]

Response samples

Content type
application/json
[
  • {
    }
]

VDS Settings

VDS Settings

Get VDS settings

Get the VDS settings

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "is_active": true,
  • "connection_identifier": "vds-1",
  • "key": "abcdef0123456789abcdef0123456789",
  • "authentication_mode": "default",
  • "address1": "192.168.100.2",
  • "port1": 5000,
  • "address2": "192.168.100.3",
  • "port2": 5000,
  • "routine_timeout": 1000,
  • "send_connection_loss": true,
  • "send_startup_routine": true,
  • "send_restart_event": true
}

Update VDS settings

Update the VDS settings

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
is_active
required
boolean

Enables VdS integration.

connection_identifier
string

The VdS-ID is used to identify the device at the VdS Control Center

key
string

The 32 digit AES VdS-Key is used to authenticate the device at the VdS Control Center

authentication_mode
string
Enum: "default" "encrypted"

The authentication mode is used to authenticate the device at the VdS Control Center. Default: First ticket of VdS Control Center is expected to be unencrypted, authentication via key number. Encryption: All tickets are encrypted. Authentication is only possible, if the correct key is known to both sides.

address1
string

The primary IPv4 address of the VdS Control Center

port1
integer

Port of the primary VdS Control Center IPv4 address

address2
string

The secondary IPv4 address of the VdS Control Center

port2
integer

Port of the secondary VdS Control Center IPv4 address

routine_timeout
integer

To signal the availability of the alerting service via VdS IP, the device sends a routine message to the VdS control center one time a day. If this message is not sent, the VdS Control Center signals an alarm.

send_connection_loss
boolean

The connection state will be checked on a daily basis. A connection loss will be sent as system notification.

send_startup_routine
boolean

A routine is sent upon establishing a connection to the VdS controlcenter.

send_restart_event
boolean

Notify successful connecting as event to the controlcenter. (Notification ID 0x53)

Responses

Request samples

Content type
application/json
{
  • "is_active": true,
  • "connection_identifier": "vds-1",
  • "key": "abcdef0123456789abcdef0123456789",
  • "authentication_mode": "default",
  • "address1": "192.168.100.2",
  • "port1": 5000,
  • "address2": "192.168.100.3",
  • "port2": 5000,
  • "routine_timeout": 1000,
  • "send_connection_loss": true,
  • "send_startup_routine": true,
  • "send_restart_event": true
}

Response samples

Content type
application/json
{
  • "is_active": true,
  • "connection_identifier": "vds-1",
  • "key": "abcdef0123456789abcdef0123456789",
  • "authentication_mode": "default",
  • "address1": "192.168.100.2",
  • "port1": 5000,
  • "address2": "192.168.100.3",
  • "port2": 5000,
  • "routine_timeout": 1000,
  • "send_connection_loss": true,
  • "send_startup_routine": true,
  • "send_restart_event": true
}

VDS Lines

VDS Line List

Get VdS lines

Get a list of all VdS lines

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create VdS line

Create a new VdS line

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

The VdS line ID.

line
integer

The VdS line number.

alarmtype
string
Enum: "armed-active" "always-active" "fire" "tampering" "arm-disarm"

The VdS alarm type.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "line": 1,
  • "alarmtype": "armed-active"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "line": 1,
  • "alarmtype": "armed-active"
}

Delete VdS lines

Delete multiple VdS lines

Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

Specific VDS Line

VDS Line Details

Get VdS line

Get a single VdS line by ID

path Parameters
lineId
required
string

ID of the VdS line to be queried

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "line": 1,
  • "alarmtype": "armed-active"
}

Update VdS line

Update a single VdS line by ID

path Parameters
lineId
required
string

ID of the VdS line to be updated

header Parameters
Accept
required
string
Value: "application/json"
Request Body schema: application/json
id
integer

The VdS line ID.

line
integer

The VdS line number.

alarmtype
string
Enum: "armed-active" "always-active" "fire" "tampering" "arm-disarm"

The VdS alarm type.

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "line": 1,
  • "alarmtype": "armed-active"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "line": 1,
  • "alarmtype": "armed-active"
}

Delete VdS line

Delete a single VdS line by ID

path Parameters
lineId
required
string

ID of the VdS line to be deleted

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "message": "The username must not be empty.",
  • "errors": {
    }
}

VDS Connection

VDS Connection Details

Get VdS state

Get the activity and connection status of the vds functionality

header Parameters
Accept
required
string
Value: "application/json"

Responses

Response samples

Content type
application/json
{
  • "active": true,
  • "connected": true
}