Внешний API

Система TargControl имеет возможность интеграции с программными продуктами пользователей (например 1С) посредством программного интерфейса (API, HTTP REST).

Для идентификации в API используется специальный ключ доступа – токен. Для того, чтобы сконфигурировать токен, перейдите в боковом меню во вкладку Администрирование → Внешний API и нажмите кнопку “+Добавить”.

В появившемся окне введите имя токена (например “1C: зарплата и управление”) и выберете роли (к каким данным системы TargControl будет иметь доступ сторонний программный продукт). Потом нажмите “Сохранить”.

Для того, чтобы включить/выключить токен, а так же изменить роли, нажмите на кнопку “Редактировать” в столбце “Действия”. В появившемся окне внесите необходимые изменения.

Сам API доступен в виде Swagger интерфейса по адресу https://api.targcontrol.com/

Для того, чтобы протестировать API, необходимо ввести созданный токен в окно Authorize.

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

Была ли данная статья полезной?
Как мы можем улучшить данную статью?
Содержание
Клиент – устройство, которое используется заказчиком для доступа к системе СКУД и УРВ, например, ПК, ноутбук, планшет и т.п. Для обеспечения доступа заказчика к системе на клиентское устройство может устанавливаться клиентская часть ПО. Также, для доступа может использоваться интернет-браузер (Chrome, Opera и т.п.).
Сервер – вычислительная система, простым языком, мощный компьютер с серверной операционной системой (ОС), на которой хранится база данных систем СКУД и УРВ, а также установлена серверная часть программного обеспечения (ПО) систем. Сервер может быть, как физическим, так и располагаться в облаке.
Терминал – составное устройство, объединяющее в себе несколько устройств (считыватель, контроллер) и функциональных возможностей. Как правило, содержит несколько считывателей (карточка, биометрия).
Контроллер – это устройство, которое обрабатывает данные, поступающие со считывателей. Принимает решение о пропуске того или иного лица, а также управляет замками. Важным параметром устройства является поддерживаемый для взаимодействия со считывателем протокол: Wiegand или RS-485. Wiegand предназначен для передачи идентификатора со считывателя на контроллер. Не поддерживает шифрование передаваемых данных, аутентификацию сторон, контроль целостности линии между считывателем и контроллером. Например, повреждение провода между считывателем и контроллером не будет обнаружена в автоматическом режиме. Максимальная длина коммуникаций для протокола 100 метров. Нельзя подключить к биометрии по прямой схеме. RS-485 выполняет ту же функцию, однако позволяет контроллеру иметь «обратную связь» со считывателями. Т.е. повреждение провода между считывателем и контроллером будет обнаружено контроллером в автоматическом режиме. 1.2 км
Замок – электронно-механическое запирающее устройство (дверь, шлагбаум, турникет и т.п.).
Считыватель – это идентификационное устройство, подключаемое к контроллеру, предназначенное для извлечения информации (идентификационного кода) с идентификатора пользователя (карта, брелок, отпечаток пальца и т.п.) и последующей передачи данных контроллеру.