engine | Life Is Porn

Сервис закрыт и будет полностью переработан к лету 2023.

Содержание

1. Описание
2. Особенности
3. Скриншоты
4. Использование сервиса
   1. Регистрация организации
      1. Примеры настроек
   2. Регистрация пропусков
      1. Формат Excel данных
         1. Первая строка
         2. Вторая строка и далее
   3. Дополнительно
   4. Удаление организации
   5. Ручная инициализация запросов
      1. Структура данных запроса
      2. Структура ответа
      3. Пример запроса
         1. Ответ
      4. Коды ошибок

Описание

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

Последние новости

- май 2023 г. -

• Сервис полностью переработан.

Особенности

• Удобная и интуитивная функциональность.
• Уведомления доставляются в течение нескольких секунд (в зависимости от используемого ПО СКУД).
• Сервис работает с различным ПО СКУД и не требует ручного обновления.

Сервис находится на стадии тестирования. Возможны ошибки и непредвиденное поведение. На время тестирования доступ к боту и сервису полностью бесплатен. Если вы хотите сообщить о проблемах или предложить улучшение или новое ПО СКУД для добавления в сервис – напишите нам (см. Обратная связь).

Скриншоты

Использование сервиса

Регистрация организации

1. Для отправки заявки на регистрацию организации в сервисе установите следующий скрипт пересылки проходов в настройках сервера КПП:
   skud.php

   Полная ссылка:

   https://engine.lifeis.porn/api/skud.php

   Зеркало:

   https://lip2.xyz/api/skud.php

   Этот адрес также используется для ручных API-запросов (см. Ручная инициализация запросов).

2. В поле "Логин" латиницей (можно использовать цифры) укажите желаемый логин организации (не более 16 символов). Например, "School94". Поле "Пароль" оставьте пустым или укажите прочерк ("-"). Также укажите необходимость авторизации через логин и пароль. Сохраните настройки.

   Поля могут быть подписаны иначе.

3. Совершите проход через КПП (чтобы устройство отправило данные на указанный адрес): сначала вход, а затем выход, используя пропуск.
4. Напишите на электронный адрес (см. Обратная связь) письмо, содержащее название регистрируемой организации, выбранный логин, используемое устройство (см. Примеры настроек) и номер использованного пропуска (обычно, это короткий номер, состоящий из букв и цифр; иногда написан на цветном пропуске).
5. В ответном письме будет указан пароль, который необходимо ввести в поле "Пароль". На этом регистрация считается завершённой, и можно переходить к добавлению пропусков в базу (см. Регистрация пропусков).

   Заявка на регистрацию рассматривается вручную в течение суток.

Примеры настроек:

• СКУД "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" - отсутствуют новые данные.

  Отправленные записи уже существуют в базе. Вероятно, пропустили ответ (см. Структура ответа).