Get logs list
Return log's list. Available events:
Access
- access_denied_by_not_valid_identifier
- access_denied_by_not_valid_face_identifier
- access_denied_by_not_valid_input_code
- access_denied_by_remote_server_api_call
- access_denied_by_unknown_card
- access_granted_by_api_call
- access_granted_by_call_host
- access_granted_by_master_code
- access_granted_by_remote_server_api_call
- access_granted_by_valid_identifier
- access_granted_by_valid_face_identifier
- door_was_closed
- access_denied_unknown_identifier
- door_sensor_was_closed
- door_was_opened
- door_sensor_was_opened
- emergency_lock_is_opened
- lock_was_opened_by_exit_btn
- lock_was_opened_by_free_access_button
- multi_access_granted
- identifiers_without_linkage_to_user_access_denied
- multi_access_denied
- lift_call_success
- lift_call_error
- lift_module_access_error
- access_granted_by_shared_identifier
- access_denied_by_not_valid_shared_identifier
Info
- incoming_call
- outgoing_call
- outgoing_call_missed
- device_booted
- sip_registration_lost
- outgoing_call_web
System
- incorrect_login_api_call
- incorrect_login_gui_settings
- successful_login_api_call
- successful_login_gui_settings
Emergency
- door_was_not_closed_too_long
- tamper_event
Query Parameters
- locale string
Possible values: [
en
,es
,ru
,uk
,pl
,nl
,tr
,fr
,da
]Default value:
en
Language for localizing logs. Value by default is 'en'
- English (en)
- Spanish (es)
- French (fr)
- Danish (da)
- Dutch (nl)
- Ukrainian (uk)
- Turkish (tr)
- Polish (pl)
- Russian (ru)
- from int64
Unix time used to get entities in a specific time window.
- Used in conjunction with
timeTo
param
- Used in conjunction with
- to int64
Unix time used to get entities in a specific time window.
- Used in conjunction with
timeFrom
param
- Used in conjunction with
- limit integer
Possible values: [
10
,20
,30
,50
]Number of items. Value by default is 10
- page_number integer
Possible values:
>= 1
Page number
- sort_type string
Possible values: [
asc
,desc
]Default value:
asc
Sort type (asc/desc)
- filter object
Filtering options for Logs
- 200
- 400
- 401
OK
- application/json
- Schema
- Example (from schema)
- Logs with options
Schema
list_option object
The model provides options can be used to sort, filter, and paginate log items
pagination object
Available pagination options for tables
total_items integerThe total number of items found and reflected across all pages
items_limit integerPossible values: [
10
,25
,50
]Limiting the display of the amount of data for one page
total_pages integerPossible values:
>= 1
The number of pages that hold the requested data
current_page integerPossible values:
>= 1
Current page number
filter object
This model describes available filter options can be used to display logs
available_filtering booleanIs filtering available
is_filtered booleanIs data filtered
available_fields object[]Available fields
available_values object
List of available filter options
category string[]Possible values: [
access
,emergency
,system
,info
]List of categories
priority string[]Possible values: [
critical
,high
,low
,medium
]Log priority
name object[]
Log name
text stringLog description
key stringPossible values: [
access_denied_by_not_valid_identifier
,access_denied_by_not_valid_face_identifier
,access_denied_by_not_valid_input_code
,access_denied_by_remote_server_api_call
,access_denied_by_unknown_card
,access_granted_by_api_call
,access_granted_by_call_host
,access_granted_by_master_code
,access_granted_by_remote_server_api_call
,access_granted_by_valid_identifier
,access_granted_by_valid_face_identifier
,door_was_closed
,door_sensor_was_closed
,door_was_opened
,door_sensor_was_opened
,emergency_lock_is_opened
,lock_was_opened_by_exit_btn
,lock_was_opened_by_free_access_button
,incoming_call
,outgoing_call
,outgoing_call_missed
,device_booted
,sip_registration_lost
,outgoing_call_web
,incorrect_login_api_call
,incorrect_login_gui_settings
,successful_login_api_call
,successful_login_gui_settings
,door_was_not_closed_too_long
,multi_access_granted
,identifiers_without_linkage_to_user_access_denied
,multi_access_denied
,access_denied_by_unknown_qr
,access_denied_unknown_identifier
,lift_call_success
,lift_call_error
,lift_module_access_error
,tamper_event
,access_granted_by_shared_identifier
,access_denied_by_not_valid_shared_identifier
]Log key that should be used for filtering
sort object
This model describes available sort options can be used to display logs
asc booleanIs used ascending order
available_sorting string[]Possible values: [
asc
,desc
]List of sort options
locale object
This model describes available languages can be used to display logs
locale stringPossible values: [
en
,es
,ru
,uk
,pl
,nl
,tr
,fr
,da
]Default value:
en
Used locale
available_locales string[]Possible values: [
en
,es
,ru
,uk
,pl
,nl
,tr
,fr
,da
]List of available locales
list_items object[]
List of logs
timestamp int64Unix Timestamp Date
category stringPossible values: [
access
,emergency
,system
,info
]Log category
priority stringLog priority
name object
Log key and name
key stringLog key. It can be used for filtering
text stringLog description
info object
This model provides detailed information about log event
model object
Represents log event raw data
anyOf- MOD2
- MOD3
- MOD4
- MOD5
- MOD6
- MOD7
- MOD8
- MOD9
- MOD10
- MOD11
- MOD12
- MOD13
- MOD14
- MOD16
- MOD17
- MOD18
- MOD19
- MOD20
- MOD21
- MOD26
- MOD27
- MOD28
- MOD29
- MOD32
- MOD33
- MOD34
status stringPossible values: [
checking
,downloading
,backuping
,installing
,finishing
,error
]Firmware updating event
account_type stringPossible values: [
admin
,manager
]Account type
account_type stringPossible values: [
admin
,manager
]Account type
number stringCall number
answered booleanIs call answered
number stringCall number
answered booleanIs call answered. Always 'true'
number integerFace ID number
type stringIdentifier type
owner stringIdentifier user name
apartment_address stringApartment address
lock integerLock number
number integerIdentifier number
type stringPossible values: [
card
,ukey
,input_code
,face_id
,qr
,license_plate
]Identifier type
owner stringIdentifier owner name
apartment_address stringIdentifier address
lock integerIdentifier lock number
code stringAccess code
lock integerOpened lock number
requestor stringPossible values: [
web_ui
,link_app
,link_server
,link_guest_url
,api
]Requestor
host stringCall host number
lock integerOpened lock number
lock integerOpened lock number
card stringcard number
qr stringQR code
identifier_number stringIdentifier number
identifier_type stringPossible values: [
card
,ukey
,input_code
,face_id
,qr
,license_plate
]Identifier type
used_identifiers_list object[]
List of identifiers
identifier_number stringIdentifier number
auth_type stringAuth type
user_name stringUser name
user_info stringUser info
apartments_list string[]List of Apartments
reject_reasons object[]
List of reject reasons
invalid_identifier object
Invalid identifier info
identifier_number stringIdentifier number
auth_type stringauth type
invalid_identifier_time_rules object[]
List of Identifiers with invalid time rule
identifier_number stringIdentifier number
auth_type stringAuth type
not_enough_passes_for_identifier object[]
List of Identifiers with invalid pass rules
identifier_number stringIdentifier number
auth_type stringAuth type
not_valid_time_profile_for_identifier object[]
List of Identifiers with not valid TimeProfile
identifier_number stringIdentifier number
auth_type stringAuth type
not_valid_time_profile_for_user object
User with not valid TimeProfile
user_name stringUser name
user_info stringUser info
not_enough_identifiers_for_current_authentication_type string[]Possible values: [
face_id
,card
,qr
]Not enough identifier for multifactor access
recognition_type_is_not_enabled object
Recognition is disabled but face_id/QR auth type is present in multifactor access or User's custom access rule
recognition_type_is_not_enabled stringPossible values: [
qr
,face_id
]Recognition type
used_identifiers_list object[]
List of used Identifiers
identifier_number stringIdentifier number
auth_type stringidentifier type
user_name stringUser name
user_info stringAdditional information about User
apartments_list string[]List of User's apartments
lock_number integerOpened lock number
identifier_number stringIdentifier number
identifier_type stringidentifier type
used_identifiers_list object[]
List of used Identifier names
name stringIdentifier name
users_list object[]
List of Users
user_name stringUser name
user_info stringUser additional info
number stringIdentifier number
type stringPossible values: [
license_plate
]Identifier type, only 'license_plate'
apartments_list string[]List of apartments
lock_number integerOpened lock number
used_identifiers_list object[]
List of used Identifier names
name stringIdentifier name
users_list object[]
List of Users
user_name stringUser name
user_info stringUser additional info
number stringIdentifier number
type stringPossible values: [
license_plate
]Identifier type, only 'license_plate'
apartments_list string[]List of Apartments
reject_reasons object[]
List of reject reasons
not_enough_passes_for_shared_identifier object[]
Not enough passes list
owner_name stringOwner name
invalid_shared_identifier_time_rules object[]
Invalid shared identifier time rules
owner_name stringOwner name
not_valid_time_profile_for_shared_identifier object[]
Not valid TimeProfile for shared Identifier
owner_name stringOwner name
not_valid_time_profile_for_user object
Not valid TimeProfile for shared User
user_name stringUser name
user_info stringUser info
number integerIdentifier number
type stringIdentifier type
owner stringOwner name
apartment_address stringAddress
lock integerOpened lock
link_id uuidUnique entity set by the server to bind some parameters with each other. By default return null value
number integerIdentifier number
type stringPossible values: [
card
,ukey
,input_code
,face_id
,qr
,license_plate
]Identifier type
owner stringOwner name
apartment_address stringAddress
lock integerOpened lock
lock_opened_time integerLock is open time in seconds
number stringCall number
answered booleanIs call answered
info object
Lift call information
user object
Caller user info
link_id uuidUnique entity set by the server to bind some parameters with each other. By default return null value
name stringUser name
destination object
Destination info
id integerDestination id
short_name stringDestination short name
lift
Lift info
id integerLift id
short_name stringLift name
info object
Lift info
user object
Caller user info
link_id uuidUnique entity set by the server to bind some parameters with each other. By default return null value
name stringUser name
destination object
Destination info
id integerDestination id
short_name stringDestination short name
error
Error message
message stringError message
info object
Caller information
user object
Caller user info
link_id uuidUnique entity set by the server to bind some parameters with each other. By default return null value
name stringUser name
error
message stringError message
text stringHuman-readable information about event
{
"list_option": {
"pagination": {
"total_items": 18,
"items_limit": 10,
"total_pages": 2,
"current_page": 1
},
"filter": {
"available_filtering": true,
"is_filtered": true,
"available_fields": [
{
"filter_field": true,
"available_types": [
"equal"
]
}
],
"available_values": {
"category": [
"access",
"emergency",
"system",
"info"
],
"priority": [
"critical",
"high",
"low",
"medium"
],
"name": [
{
"text": "Unknown identifier",
"key": "access_denied_by_unknown_card"
}
]
}
},
"sort": {
"asc": true,
"available_sorting": [
"asc",
"desc"
]
},
"locale": {
"locale": "en",
"available_locales": [
"en",
"es",
"ru",
"uk",
"pl",
"nl",
"tr",
"fr",
"da"
]
}
},
"list_items": [
{
"timestamp": 1540819272,
"category": "access",
"priority": "high",
"name": {
"key": "incoming_call",
"text": "Access denied by web interface"
},
"info": {
"model": {},
"text": "Lock 1 opened from the web interface"
}
}
]
}
{
"list_option": {
"pagination": {
"total_pages": 1,
"items_limit": 10,
"total_items": 1,
"current_page": 1
},
"filter": {
"available_filtering": true,
"available_fields": [
{
"available_types": [
"equal"
],
"filter_field": "priority"
},
{
"available_types": [
"equal"
],
"filter_field": "category"
},
{
"available_types": [
"equal"
],
"filter_field": "name"
}
],
"available_values": {
"category": [
"emergency",
"access",
"system",
"info"
],
"priority": [
"low",
"critical",
"medium",
"high"
],
"name": [
{
"text": "SIP registration lost",
"key": "sip_registration_lost"
},
{
"text": "Unknown identifier",
"key": "access_denied_by_unknown_card"
},
{
"text": "Wrong input code",
"key": "access_denied_by_not_valid_input_code"
},
{
"text": "Access granted by remote server",
"key": "access_granted_by_remote_server_api_call"
},
{
"text": "Missed outgoing call",
"key": "outgoing_call_missed"
},
{
"text": "Door is not closed too long",
"key": "door_was_not_closed_too_long"
},
{
"text": "Unknown QR code",
"key": "access_denied_by_unknown_qr"
},
{
"text": "Lock opened by response device",
"key": "access_granted_by_call_host"
},
{
"text": "Door was closed",
"key": "door_was_closed"
},
{
"text": "Lock opened by free access button",
"key": "lock_was_opened_by_free_access_button"
},
{
"text": "Outgoing call",
"key": "outgoing_call"
},
{
"text": "Device booted",
"key": "device_booted"
},
{
"text": "Failed login attempt to the GUI settings",
"key": "incorrect_login_gui_settings"
},
{
"text": "Entered to GUI settings",
"key": "successful_login_gui_settings"
},
{
"text": "Incoming call",
"key": "incoming_call"
},
{
"text": "Door was opened",
"key": "door_was_opened"
},
{
"text": "Access denied by remote server",
"key": "access_denied_by_remote_server_api_call"
},
{
"text": "Door sensor opened",
"key": "door_sensor_was_opened"
},
{
"text": "Not valid face identifier",
"key": "access_denied_by_not_valid_face_identifier"
},
{
"text": "Failed login attempt to the web interface",
"key": "incorrect_login_api_call"
},
{
"text": "Not valid identifier",
"key": "access_denied_by_not_valid_identifier"
},
{
"text": "Access granted",
"key": "access_granted_by_api_call"
},
{
"text": "Lock opened by identifier",
"key": "access_granted_by_valid_identifier"
},
{
"text": "The lock is open on alarm",
"key": "emergency_lock_is_opened"
},
{
"text": "Lock opened by exit button",
"key": "lock_was_opened_by_exit_btn"
},
{
"text": "General access code entered",
"key": "access_granted_by_master_code"
},
{
"text": "Lock opened by face identifier",
"key": "access_granted_by_valid_face_identifier"
},
{
"text": "Door sensor closed",
"key": "door_sensor_was_closed"
},
{
"text": "Login to the web interface",
"key": "successful_login_api_call"
},
{
"text": "Outgoing call from web",
"key": "outgoing_call_web"
},
{
"text": "Tamper triggered",
"key": "tamper_event"
},
{
"text": "Multi factor access granted",
"key": "multi_access_granted"
},
{
"text": "Multi factor access denied",
"key": "multi_access_denied"
},
{
"text": "Identifiers without linkage to user are not allowed",
"key": "identifiers_without_linkage_to_user_access_denied"
},
{
"text": "Access denied by unknown identifier",
"key": "access_denied_unknown_identifier"
},
{
"text": "Successful lift call",
"key": "lift_call_success"
},
{
"text": "Failed to call the lift",
"key": "lift_call_error"
},
{
"text": "Cannot access lift module",
"key": "lift_module_access_error"
},
{
"text": "Access granted by shared identifier",
"key": "access_granted_by_shared_identifier"
},
{
"text": "Access denied by shared identifier",
"key": "access_denied_by_not_valid_shared_identifier"
}
]
}
},
"locale": {
"available_locales": [
"pl",
"uk",
"en",
"ru",
"es",
"nl",
"tr",
"fr",
"da"
],
"locale": "en"
},
"sort": {
"asc": false,
"available_values": [
"asc",
"desc"
]
}
},
"list_items": [
{
"timestamp": 1608292485815,
"category": "system",
"priority": "medium",
"name": {
"text": "Login to the web interface",
"key": "successful_login_api_call"
},
"info": {
"text": "Successful (admin) login to the web interface",
"model": {
"account_type": "admin"
}
}
}
]
}
Base errors for all entities
- Wrong pagination limit
- Wrong page number
- Wrong filter type
- Wrong filter field
- Wrong filter format
- Wrong filter value
- Wrong sort type
Errors appeared only in log entities: - Wrong time format
- Wrong time range: 'to' must be greater then 'from'
Errors appeared in other entities: - Wrong sort field
- application/json
- Schema
- Example (from schema)
- Pagination Limit
- Pagination Page Number
- Sort type
- Sort field
- Filter type
- Filter field
- Filter value
- Filter format
- Time format
- Time range
Schema
- error string
Error message
{
"error": "Administrator rights required"
}
{
"error": "Wrong pagination limit"
}
{
"error": "Wrong page number"
}
{
"error": "Wrong sort type"
}
{
"error": "Wrong sort field"
}
{
"error": "Wrong filter type"
}
{
"error": "Wrong filter field"
}
{
"error": "Wrong filter value"
}
{
"error": "Wrong filter format"
}
{
"error": "Wrong time format"
}
{
"error": "Wrong time range: 'to' must be greater then 'from'"
}
Unauthorized request. Log In
- application/json
- Schema
- Example (from schema)
- Log In
Schema
- error string
Error message
{
"error": "Log In"
}
{
"error": "Log In"
}