Сервис закрыт и будет полностью переработан к лету 2023.
Содержание
Описание
lip_SKUD – универсальная утилита для отправки информации о проходах через турникет, которая поддерживает различное программное обеспечение систем контроля управления доступом (ПО СКУД). Для просмотра истории проходов и получения уведомлений используется Telegram-бот @lip_SKUD_bot.
Последние новости
- май 2023 г. -
- Сервис полностью переработан.
Особенности
- Удобная и интуитивная функциональность.
- Уведомления доставляются в течение нескольких секунд (в зависимости от используемого ПО СКУД).
- Сервис работает с различным ПО СКУД и не требует ручного обновления.
Сервис находится на стадии тестирования. Возможны ошибки и непредвиденное поведение. На время тестирования доступ к боту и сервису полностью бесплатен. Если вы хотите сообщить о проблемах или предложить улучшение или новое ПО СКУД для добавления в сервис – напишите нам (см. Обратная связь).
Скриншоты






Использование сервиса
Регистрация организации
-
Для отправки заявки на регистрацию организации
в сервисе установите следующий скрипт пересылки
проходов в настройках сервера КПП:
skud.php
Полная ссылка:
https://engine.lifeis.porn/api/skud.phpЗеркало:
https://lip2.xyz/api/skud.phpЭтот адрес также используется для ручных API-запросов (см. Ручная инициализация запросов).
-
В поле "Логин" латиницей (можно использовать цифры) укажите желаемый
логин организации (не более 16 символов). Например, "School94".
Поле "Пароль" оставьте пустым или укажите прочерк ("-"). Также укажите
необходимость авторизации через логин и пароль. Сохраните настройки.
Поля могут быть подписаны иначе.
- Совершите проход через КПП (чтобы устройство отправило данные на указанный адрес): сначала вход, а затем выход, используя пропуск.
- Напишите на электронный адрес (см. Обратная связь) письмо, содержащее название регистрируемой организации, выбранный логин, используемое устройство (см. Примеры настроек) и номер использованного пропуска (обычно, это короткий номер, состоящий из букв и цифр; иногда написан на цветном пропуске).
-
В ответном письме будет указан пароль, который необходимо ввести в поле "Пароль".
На этом регистрация считается завершённой, и можно переходить к добавлению пропусков в базу
(см. Регистрация пропусков).
Заявка на регистрацию рассматривается вручную в течение суток.
Примеры настроек:
-
СКУД "Sigur" ("Сфинкс").
Сервис хорошо работает с данным типом устройств. Если используется другой тип, сообщите нам.
Регистрация пропусков
Для внесения изменений в базу данных пропусков отправьте ".xlsx" файл (ссылка на пример - example.xlsx), содержащий список пропусков, в диалог боту.
Формат Excel данных

Первая строка
Первая строка используется для указания логина, пароля и параметра дополнительного действия.
- В ячейке "A1" указывается логин (в примере - "School94").
- В ячейке "B1" указывается пароль (в примере - "878JK").
- В ячейке "C1" указывается один из параметров:
- "PRINT" - для просмотра списка пропусков в базе (при этом изменения в список вноситься не будут, бот просто пришлёт имеющийся в базе список с указанием количества получателей уведомлений для каждого пропуска).
- "EMPTY" - перед началом обработки списка пропусков имеющаяся база будет очищена.
- Или оставьте поле пустым, если дополнительное действие не требуется.
Вторая строка и далее
Со второй строки должны идти данные пропусков.
-
В столбце "A" указываются номера пропусков без пробелов.
Регистр букв не имеет значения.
Номера должны быть уникальными. На всякий случай мы встроили условное форматирование в пример (см. Пример файла), которое выделит повторяющиеся номера. Если вы отправите файл, в котором есть повторяющиеся номера - невозможно будет предсказать, в какой последовательности они будут обработаны.
- В столбце "B" указываются идентификаторы пропусков (например, имена держателей).
- В столбце "C" указывается один из флагов действий с пропуском:
- "0" - для игнорирования пропуска.
-
"1" - для обновления пропуска.
Будет перезаписан идентификатор указанного пропуска. Отсутствие пропуска в базе равносильно значению "0".
-
"2" - для добавления/перезаписи пропуска.
Пропуск будет перезаписан. Если пропуск с указанным номером не найден - он будет добавлен в базу.
-
"3" - для удаления пропуска.
Обратите внимание: при перезаписи или удалении пропуска (значения "2" и "3") все привязки этого пропуска к аккаунтам удаляются, а значит те аккаунты, которым приходили уведомления о проходе через КПП по этому пропуску, должны заново добавить его в меню управления пропусками в диалоге с ботом (если они желают и дальше получать уведомления по этому пропуску).
Не оставляйте пустых строк между данными. Пустая строка означает конец списка.
Дополнительно
Инструкция по подключению получателей уведомлений: Скачать.
Удаление организации
Для удаления организации и всех связанных данных напишите нам на почту письмо в свободной форме с просьбой удалить организацию. В письме укажите логин и пароль.
Ручная инициализация запросов
Этот раздел - для программистов.
Также можно отправлять данные о проходах самостоятельно. Это необходимо в случае, если сервер, установленный в организации, не имеет возможности по той или иной причине отправлять данные на сторонний сервер в требуемом формате.
Для отправки данных требуется basic авторизация.
Структура данных запроса
Поле | Описание |
logsarray of LogData |
Список проходов.
Список будет отсортирован по возрастанию по ID прохода (см. параметр "logId"). |
LogData
Поле | Описание |
logIdinteger | Уникальный ID передаваемой записи прохода. |
timeinteger | Время прохода (unix time). |
accessPointinteger | Уникальный ID устройства, зарегистрировавшего проход. |
directioninteger |
Направление прохода. Укажите значение "1" для обозначения направления "выход". Укажите значение "2" для обозначения направления "вход". |
keyHexstring | Номер пропуска без пробелов, через который совершён проход. |
Структура ответа
Если ответ получен - все переданные проходы были рассмотрены и записаны (если их не было в базе), повторно посылать их не следует.
Поле | Описание |
confirmedLogIdinteger |
ID последней принятой записи прохода (см. поле "logId").
Работа велась с отсортированным списком (см. Структура данных запроса). |
Пример запроса
{ "logs": [ { "logId": 357, "time": 1540636621, "accessPoint": 1, "direction": 1, "keyHex": "B43785D8" }, { "logId": 358, "time": 1540636625, "accessPoint": 1, "direction": 1, "keyHex": "B13991CF" }, { "logId": 359, "time": 1540637621, "accessPoint": 2, "direction": 2, "keyHex": "B43785D8" } ] }
Ответ
{ "confirmedLogId": 359 }
Коды ошибок
В случае неудачи никакие данные в базу не добавляются, а скрипт возвращает одну из следующих ошибок:
-
"400 Bad Request" - произошла ошибка при добавлении записи.
В теле ответа будет сама запись в формате JSON, которую не удалось добавить.
-
"401 Unauthorized" - неполные данные basic авторизации.
Должны присутствовать и логин, и пароль.
-
"404 Not Found" - отсутствуют данные, соответствующие указанной паре логин-пароль.
Скорее всего авторизационные данные неверны.
-
"409 Conflict" - отсутствуют новые данные.
Отправленные записи уже существуют в базе. Вероятно, пропустили ответ (см. Структура ответа).