Get list of OSDP devices notification settings
Returns list of OSDP devices notification settings
- 200
- 401
OK
- application/json
- Schema
- Example (from schema)
Schema
items object[]
List of OSDP devices
hardware_info object
General hardware information
vendor_code stringUnique device vendor code
model_number integerModel number of the device
version integerVersion of the device
firmware stringFirmware version
serial_number integerSerial number of the device
connection object
Device connection extra information
is_active booleanDetermines if OSDP device online
is_enabled booleanDetermines if controller poll OSDP device
connection_status stringPossible values: [
success,connection_timeout,invalid_security_key]Describes OSDP connection status info
port_number integerPossible values:
>= 1and<= 2Unique RS485 interface number. Can be in range 1-2
address integerPossible values:
<= 126Address of the device on th RS485 bus
channel_type stringPossible values: [
secure,not_secure]Channel type for device connection
name stringPossible values:
<= 100 charactersName of reader
indication object
OSDP device indication settings information
oneOf- MOD1
- MOD2
is_abilities_type_valid booleandescribes whether the ability type specified by the user matches the ability type of the device
controlled_by stringPossible values: [
controller,device]Device control type.
If set to "controller", all led and buzzer manipulation managed by controller via OSDP commands. If set to "device", led and buzzer are working with OSDP device default(built-in) indication settings.
max_led_number integerPossible values:
<= 255Number of led installed
abilities_type integerPossible values:
>= 1and<= 4Information about available device control settings type. Device control settings type controlled by Function Code 4 (FC4).
1 – the PD support on/off control only 2 – the PD supports timed commands 3 – like 02, plus bi-color LEDs 4 – like 02, plus tri-color LEDs
is_abilities_type_valid booleandescribes whether the ability type specified by the user matches the ability type of the device
controlled_by stringPossible values: [
controller,device]Device control type.
If set to "controller", all led and buzzer manipulation managed by controller via OSDP commands. If set to "device", led and buzzer are working with OSDP device default(built-in) indication settings.
max_led_number integerPossible values:
<= 255Number of led installed
abilities_type integerPossible values:
>= 1and<= 4Information about available device control settings type. Device control settings type controlled by Function Code 4 (FC4).
1 – the PD support on/off control only 2 – the PD supports timed commands 3 – like 02, plus bi-color LEDs 4 – like 02, plus tri-color LEDs
states object
LIst of events and their settings
idle object
Indication state settings info
buzzer object
Buzzer settings
is_enabled booleanIs buzzer enabled
on_time integerPossible values:
>= 1and<= 255The ON duration of the sound, in units of 100 ms. Must be nonzero. 1 means 100ms, 255 means 25500ms
off_time integerPossible values:
<= 255The OFF duration of the sound, in units of 100 ms. 1 means 100ms, 255 means 25500ms.
beep_count integerPossible values:
<= 255Number of beeps repeated.
0 = tone continues until another tone command is received
led object
indication state led extra info
items object
List of led settings
oneOf- MOD1
- MOD2
- MOD3
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
valid_identifier object
Indication state settings info
buzzer object
Buzzer settings
is_enabled booleanIs buzzer enabled
on_time integerPossible values:
>= 1and<= 255The ON duration of the sound, in units of 100 ms. Must be nonzero. 1 means 100ms, 255 means 25500ms
off_time integerPossible values:
<= 255The OFF duration of the sound, in units of 100 ms. 1 means 100ms, 255 means 25500ms.
beep_count integerPossible values:
<= 255Number of beeps repeated.
0 = tone continues until another tone command is received
led object
indication state led extra info
items object
List of led settings
oneOf- MOD1
- MOD2
- MOD3
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
invalid_identifier object
Indication state settings info
buzzer object
Buzzer settings
is_enabled booleanIs buzzer enabled
on_time integerPossible values:
>= 1and<= 255The ON duration of the sound, in units of 100 ms. Must be nonzero. 1 means 100ms, 255 means 25500ms
off_time integerPossible values:
<= 255The OFF duration of the sound, in units of 100 ms. 1 means 100ms, 255 means 25500ms.
beep_count integerPossible values:
<= 255Number of beeps repeated.
0 = tone continues until another tone command is received
led object
indication state led extra info
items object
List of led settings
oneOf- MOD1
- MOD2
- MOD3
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
is_enabled booleanDetermines if LED enabled
number integerPossible values:
<= 255Number of led that related to settings.
Cannot be greater than max led numbers.
on_time integerPossible values:
<= 255The ON duration of the light, in units of 100 ms.
off_time integerPossible values:
<= 255The OFF duration of the light, in units of 100 ms.
on_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The ON duration light color.
Depends on indication abilities.
off_color stringPossible values: [
black,red,green,amber,blue,magenta,cyan,white]The OFF duration light color.
Depends on indication abilities.
blink_timer integerPossible values:
<= 255Number of blinks repeated, in units of 100 ms.
0 = light continues until another tone command is received
{
"items": [
{
"hardware_info": {
"vendor_code": "vendor code",
"model_number": 2,
"version": 0,
"firmware": "1.2.345",
"serial_number": 0
},
"connection": {
"is_active": true,
"is_enabled": true,
"connection_status": "success",
"port_number": 1,
"address": 0,
"channel_type": "not_secure"
},
"name": "Main entrance reader",
"indication": {
"is_abilities_type_valid": false,
"controlled_by": "device",
"max_led_number": 2,
"abilities_type": 1
}
}
]
}
Unauthorized request. Log In
- application/json
- Schema
- Example (from schema)
- Example
Schema
error object
Error object, contains error details
code stringPossible values: [
invalid_authentication,permission_denied,not_valid,system_error,bad_request,connection_timeout]Error code
message stringError message
data object
Did not pass validation parameters. Can be represented as an object, which can include field names, arrays, query parameters etc.
param stringContains validation error details
{
"error": {
"code": "not_valid",
"message": "Data validation error",
"data": {
"param": "must be an string"
}
}
}
{
"error": {
"code": "invalid_authentication",
"message": "Invalid authentication"
}
}