Swagger-описание API доступно по ссылке api.targcontrol.com. Если у вас еще нет учетной записи в TargControl Cloude используйте для тестирования токен, который был создан на демо странице управления: 4fd198b5-6497-4d6d-aa98-647db1242d9e
Токен можно найти в вашей учетной записи TargControl Cloud в разделе Администрирование - Внешний API на странице управления токенами.
Webhooks
TargControl может отправлять уведомления в сторонние системы по протоколу HTTP (так же доступны уведомления на Email, Slack, Telegram) в реальном времени при наступлении определенных типов событий.
События, о которых могут быть уведомлены сторонние системы:
События доступа (вход/выход сотрудников, пожарная тревога и другие)
События устройств (контроллер не выходит на связь, произошла ошибка и другие)
Отчеты (генерация на сервере по расписанию)
События справок и инструктажей (если у сотрудника заканчивается справка, например)
Настройка Webhook осуществляется в 3 этапа:
Добавьте канал доставки HTTP
Настройте канал HTTP
Настройте события, о которых необходимо уведомлять. Ниже приведен пример для Событий доступа сотрудников.
Клиент – устройство, которое используется заказчиком для доступа к системе СКУД и УРВ, например, ПК, ноутбук, планшет и т.п. Для обеспечения доступа заказчика к системе на клиентское устройство может устанавливаться клиентская часть ПО. Также, для доступа может использоваться интернет-браузер (Chrome, Opera и т.п.).
Сервер – вычислительная система, простым языком, мощный компьютер с серверной операционной системой (ОС), на которой хранится база данных систем СКУД и УРВ, а также установлена серверная часть программного обеспечения (ПО) систем. Сервер может быть, как физическим, так и располагаться в облаке.
Терминал – составное устройство, объединяющее в себе несколько устройств (считыватель,
контроллер) и функциональных возможностей. Как правило, содержит несколько считывателей
(карточка, биометрия).
Контроллер – это устройство, которое обрабатывает данные, поступающие со считывателей. Принимает
решение о пропуске того или иного лица, а также управляет замками. Важным параметром устройства
является поддерживаемый для взаимодействия со считывателем протокол: Wiegand или RS-485.
Wiegand предназначен для передачи идентификатора со считывателя на контроллер. Не поддерживает
шифрование передаваемых данных, аутентификацию сторон, контроль целостности линии между
считывателем и контроллером. Например, повреждение провода между считывателем и контроллером
не будет обнаружена в автоматическом режиме. Максимальная длина коммуникаций для протокола
100 метров. Нельзя подключить к биометрии по прямой схеме.
RS-485 выполняет ту же функцию, однако позволяет контроллеру иметь «обратную связь»
со считывателями. Т.е. повреждение провода между считывателем и контроллером будет обнаружено
контроллером в автоматическом режиме. 1.2 км
Замок – электронно-механическое запирающее устройство (дверь, шлагбаум, турникет и т.п.).
Считыватель – это идентификационное устройство, подключаемое
к контроллеру, предназначенное для извлечения информации
(идентификационного кода) с идентификатора пользователя (карта,
брелок, отпечаток пальца и т.п.) и последующей передачи данных
контроллеру.