External API: Получение уведомлений от СКУД
Входящая подписка: Подключение СКУД по JSON
Подписка на события позволяет системе UnSpot получать уведомления о событиях из других систем, использующих систему контроля доступа (СКУД) в реальном времени. Этот инструмент обеспечивает интеграцию между UnSpot и СКУД через HTTPS-запросы и подходит для различных систем, работающих с форматом JSON.
Когда в СКУД происходит событие (например, пользователь проходит через систему контроля доступа), информация об этом передается в UnSpot, где обновляется следующая информация:
– Статус “В офисе” отображается в карточке пользователя и на карте.
– Автоматически подтверждается бронирование на втором этапе чекина, если соответствующие политики включены для рабочих мест.
– Информация появляется в отчете «История посещения офиса (СКУД)», который доступен только для администратора.
Для настройки подписки необходимо создать URL-адрес, на который СКУД будет отправлять данные о событиях. Для этого выполните следующие шаги:
1. Перейдите в раздел Настройка → Интеграции → Входящие подписки.
2. Нажмите на кнопку “Добавить входящую подписку“.
3. В поле «Способ передачи данных» выберите “JSON”.
4. В блоке «Настройка формата разметки данных» укажите ключи JSON, в которых ваша СКУД передаёт данные. Все четыре поля обязательны; форма заранее подставляет значения office, location, email и status:
- Офис – ключ с названием точки доступа (турникета, двери), через которую прошёл сотрудник. По нему UnSpot определит офис посещения — см. шаг 6.
- Место – ключ с названием места. Этот ключ должен приходить в каждом событии, иначе событие отклоняется.
- Пользователь – ключ с идентификатором сотрудника: email, номером пропуска, ФИО или отображаемым именем.
- Статус – ключ с направлением прохода:
in_office— вход,out_office— выход.
Пример соответствия атрибутов (маппинг атрибутов):
Важно: СКУД, в качестве значений статуса, принимает только: “in_office” и “out_office“
5. Токен:
Для снижения рисков несанкционированного доступа и улучшения защиты передачи данных рекомендуется использовать секретный токен в запросах.
После нажатия кнопки “Добавить токен” создается уникальный токен, доступный для копирования только в момент создания подписки (в дальнейшем он не будет доступен для копирования). Повторная генерация токена для существующей подписки невозможна.
Если токен утрачен или забыт, потребуется удалить текущую подписку, создать новую и заново сгенерировать токен.
6. При необходимости заполните блок «Связь офиса с точкой доступа СКУД»: нажмите «Добавить офис», выберите офис или вложенное в него пространство (например, этаж), затем в поле «Укажите точку доступа» нажмите «Добавить» и введите значение, которое СКУД передаёт в ключе «Офис», — например, название турникета. Так UnSpot узнает, в какой офис пришёл сотрудник, и запишет его в отчёт «История посещения офиса (СКУД)». Без этого блока подписка работает, но офис посещения не определяется. Правила для точек доступа — в статье «Входящие вебхуки: подключение СКУД».
7. После ввода необходимых данных нажмите кнопку “Добавить“ для создания подписки.
———–
После добавления подписки URL-ссылка будет автоматически сгенерирована на странице, и вы сможете использовать ее для передачи данных из других систем.
- Вы можете скопировать сгенерированную ссылку для дальнейшего использования в других системах, интегрированных со СКУД. В ссылке автоматически создается токен для обеспечения безопасного подключения.
- При необходимости вы можете активировать или деактивировать подписку.
- Если атрибуты изменятся, у вас есть возможность редактировать подписку или удалить ее.
