Для интеграции Promobot Control и СКУД необходимо реализовать сервис для обращения к методам СКУД и указать адрес данного сервиса в настройках.
Описание методов в формате swagger располагается по адресу:
https://control.promo-bot.ru/skudapi/index.html
Особенности методов:
- CheckAccessByPersonInfo. Обязательными параметрами являются только фамилия и имя, передача остальных сведений осуществляется только при определенных настройках системы. В связи с этим рекомендуется игнорировать при поиске заявок параметры, имеющие пустое значение (пустая строка или null). Также рекомендуется игнорировать регистр строк при сравнении, т.к. регистр не является фиксированным.
- CreateVisitWithoutRequest. Аналогично особенностям метода CheckAccessByPersonInfo.
- GenerateAccessQRCode. Данные (температура посетителя и время посещения) дублируются с методами CreatePass и CreateVisitWithoutRequest, т.к. они могут быть необходимы для формирования значения qr-кода. Размер строки не рекомендуется делать более 150 символов в связи с ограничениями на размер изображения.
Сервис должен предоставлять следующие методы:
Название метода | Краткое описание | Условия обязательности |
GetCardholderInfo | Получить сведения о держателе карты по CardID | При включении возможности входа по пропуску (по карте) |
CheckAccessByPersonInfo | Проверить возможность входа по данным личности | Всегда |
CreatePass | Зафиксировать факт входа по найденной заявке | При необходимости фиксации факта входа в СКУД |
CreateVisitWithoutRequest | Зафиксировать факт входа по данным личности, прошедшей без предварительной заявки | При необходимости фиксации факта входа в СКУД и включенной возможности свободного входа (без заявки) |
GenerateAccessQRCode | Получить строку для формирования QR-кода на выданном пропуске | При выдаче бумажного пропуска и необходимости печати QR-кода на нем |
BlockCard | Заблокировать карту при высокой температуре посетителя | При включении возможности входа по пропуску (по карте) и необходимости блокировки карты при высокой температуре посетителя |
ActivateCard | Активировать карту при нормальной температуре | При включении возможности входа по пропуску (по карте) и необходимости активации карты при нормальной температуре посетителя |
GetCompaniesInfo | Получить справочник компаний и сотрудников | При включенной возможности выбора места назначения при отсутствии предварительной заявки |
Схема вызова методов представлена на следующем рисунке:
