External API: Получение уведомлений от СКУД

Входящая подписка: Подключение СКУД по JSON

Подписка на события позволяет системе UnSpot получать уведомления о событиях из других систем, использующих систему контроля доступа (СКУД) в реальном времени. Этот инструмент обеспечивает интеграцию между UnSpot и СКУД через HTTPS-запросы и подходит для различных систем, работающих с форматом JSON.

Когда в СКУД происходит событие (например, пользователь проходит через систему контроля доступа), информация об этом передается в UnSpot, где обновляется следующая информация:
– Статус “В офисе” отображается в карточке пользователя и на карте.
– Автоматически подтверждается бронирование на втором этапе чекина, если соответствующие политики включены для рабочих мест.
– Информация появляется в отчете “История посещений офиса (СКУД)“, который доступен только для администратора.

Для настройки подписки необходимо создать URL-адрес, на который СКУД будет отправлять данные о событиях. Для этого выполните следующие шаги:

1. Перейдите в раздел Настройки > Интеграции > Входящие подписки.
2. Нажмите на кнопку “Добавить входящую подписку“.
3. В настройках подключения выберите формат передачи данных “JSON”
4. Установите соответствие атрибутов с вашей системой:

• Офис – введите атрибут пространства.
• Место – введите атрибут рабочего места.
• Пользователь – введите атрибут email адреса пользователя.
• Статус – введите атрибут для входа и выхода через СКУД.

Пример соответствия атрибутов (маппинг атрибутов):

Важно: СКУД, в качестве значений статуса, принимает только: “in_office” и “out_office“

5. Токен:  
Для снижения рисков несанкционированного доступа и улучшения защиты передачи данных рекомендуется использовать секретный токен в запросах.  
После нажатия кнопки “Добавить токен” создается уникальный токен, доступный для копирования только в момент создания подписки (в дальнейшем он не будет доступен для копирования). Повторная генерация токена для существующей подписки невозможна.  
Если токен утрачен или забыт, потребуется удалить текущую подписку, создать новую и заново сгенерировать токен.

6. После ввода необходимых данных нажмите кнопку “Добавить“ для создания подписки.

———–

После добавления подписки URL-ссылка будет автоматически сгенерирована на странице, и вы сможете использовать ее для передачи данных из других систем.

1. Вы можете скопировать сгенерированную ссылку для дальнейшего использования в других системах, интегрированных со СКУД. В ссылке автоматически создается токен для обеспечения безопасного подключения.
2. При необходимости вы можете активировать или деактивировать подписку.
3. Если атрибуты изменятся, у вас есть возможность редактировать подписку или удалить ее.