GET /ReadLogLock
Формат параметров – JSON
Данная команда отличается для онлайн и оффлайн замков.
Для оффлайн замков у вас должна быть специальная карта чтения данных, которую нужно предварительно запрограммировать через OZLocks Hotelier Pro. Далее с помощью этой картой нужно считать лог замка и положить на программатор. Данная команда считывает карту и представит лог его в ответном сообщении.
Для онлайн замков чтение лога произойдет непосредственно с замка.
Параметры:
| Наименование | Тип | Описание |
| EncoderID | String | ID энкодера, на котором читается карта данных |
| required* | ||
| WorkstationID | String | ID рабочего места с которого выполняется запрос |
| required | ||
| Room | String | Наименование номера, лог которого нужно получить |
| required | ||
| ShowErrorEntrance | Boolean |
Если флаг установлен или не задан, то в логе будут отображаться записи попытки несанкционированного доступа. Если флаг снят, то такие записи не будут добавлены в лог. Прим. Не все замки поддерживают записи несанкционированного доступа. Так же ведение таких записей в лог могут быть отключены при инициализации замка. |
* — Обязательно для оффлайн замков. Для онлайн — не указывать.
** — Обязательно для онлайн замков. Для оффлайн — не указывать.
Пример:
|
{ "EncoderID": "001", "WorkstationID": "ADMIN01" } |
Код ответа – 200: OK
Формат ответа – JSON
Параметры:
| Наименование | Тип | Описание |
| EncoderID | String | ID энкодера, на котором читается карта данных |
| required* | ||
| WorkstationID | String | ID рабочего места с которого выполняется запрос |
| required | ||
| Log | Массив LogState | Массив записей об открытии замка. Для некоторых версий замков так же попытки получения несанкционированного доступа |
* — Обязательно для оффлайн замков. Для онлайн — необязательно.
Запись LogState:
| Наименование | Тип | Описание |
| RecordType | Integer | Тип записи лога |
| required | ||
| RecordTypeEx | String | Наименование типа записи лога |
| required | ||
| EventTime | String | Дата и время события в формате «ДД.MM.ГГГГ ЧЧ:ММ» |
| required | ||
| HolderID | String | ID карты, которая выполняла действие. Для другого способа авторизации, например, по коду — ID записи ключа авторизации |
| required | ||
| HolderName | String | ФИО гостя для карт гостя. Или ФИО сотрудника — для карт персонала. Если в системе OZLocks не будет найдена связь между HolderID и ФИО владельца |
Пример:
|
{ "EncoderID": "001", "WorkstationID": "ADMIN01", "Log": [ { "RecordType": 6, "RecordTypeEx": "Карта гостя", "EventTime": "04.09.2025 16:21", "HolderID": 12, "HolderName": "Иванов Иван", }, { "RecordType": 17, "RecordTypeEx": "Код гостя", "EventTime": "07.09.2025 16:22", "HolderID": 12, "HolderName": "Иванов Иван", }, ] } |
Код ответа — 400: Сервер не доступен
Код ответа — 401: Не прошла авторизация
Код ответа — 500: Ошибка данных запроса
Формат ответа – JSON
| Наименование | Тип | Описание |
| ECode | String | Код ошибки |
| required | ||
| EMessage | String | Сообщение об ошибке |
| required |
Пример:
|
{ "ECode": "2", "EMessage": "Карта отсутствует на устройстве" } |
