Какие терминалы поддерживает шлюз, как подключается каждый из них (Native Push или Hybrid Push) и какие операции API доступны в каждом режиме.
Введение
Совместимость устройств
Cams Biometric Gateway поддерживает все биометрические терминалы учёта посещаемости и контроля доступа. Вам нужно лишь выбрать режим подключения, который подходит для вашей инфраструктуры.
Любой другой терминал работает через Hybrid Push. Вы выбираете режим подключения, подходящий для вашей инфраструктуры, — возможности API зависят от выбранного режима.
Поддерживаемые бренды устройств
Cams BiometricsZKTecoSupremaHikvisionAnvizMorpho / IDEMIAVirdiMantraNitgenRealtime / StartekBiomaxSecugeneSSLMatrix COSEC+ Любой другой бренд
Биометрические терминалы Cams: SlimBeast (i34), Macronium (i35), Hawking Plus (f38+), Hawking (f38), Ultron MultiFaceFP (f34), Ultron MultiFace (f35), Galaxy (f36), Ultron GPS (f37), CanBio34, GymBio34, RSP10i3, RSP10f1 и другие.
Введение
Режимы подключения и доступность API
Каждый биометрический терминал подключается к Cams Biometric Gateway в одном из двух push-режимов. Режим определяется типом вашего устройства.
Native Push Устройства Cams и проверенные устройства
Все терминалы Cams Biometrics и устройства, проверенные на developer.camsbiometrics.com, подключаются через Native Push. Дополнительная настройка не требуется — устройство обменивается данными с Biometric Gateway напрямую через интернет.
Полная поддержка API. Все 38 операций работают без ограничений — и Callback API, и RESTful API. Нулевая задержка для callback, ~15 секунд для RESTful-команд.
Hybrid Push Все остальные терминалы
Для терминалов не от Cams и не проверенных вы выбираете режим подключения Hybrid Push, подходящий для вашей среды. Набор доступных функций API определяется сочетанием способа обмена данными и топологии развёртывания.
Способы обмена данными
(a) SDK устройстваШлюз взаимодействует с оборудованием через SDK производителя устройства. Через API доступны все функции, которые поддерживает SDK. Лучший вариант для полного доступа к API.
(b) Чтение из БДШлюз считывает данные из локальной базы данных, установленной на компьютере на объекте (где ПО устройства хранит посещаемость). Поддерживается только отправка журнала посещаемости/отметок на ваш сервер. Без RESTful API (нет добавления и удаления пользователей, загрузки журнала и т. д.).
(c) Обработка файлаУказанный файл посещаемости на локальном компьютере находится под постоянным наблюдением. Каждый раз, когда ПО устройства обновляет файл, новые записи посещаемости автоматически обнаруживаются, считываются и отправляются на ваш Callback URL в реальном времени. Ограничения API те же, что и при чтении из БД -- только отправка посещаемости, без RESTful API.
Топологии развёртывания
(X) ПрямаяУ компьютера на объекте есть публичный IP с пробросом портов в локальную сеть. Biometric Gateway подключается к устройству/БД/файлам напрямую через интернет.
(Y) НепрямаяНа локальный компьютер устанавливается Hybrid Connector. Он служит мостом между локальным устройством/БД/файлами и Biometric Gateway — публичный IP на стороне клиента не нужен.
Hybrid Push — матрица доступных функций
Режим
Способ обмена данными
Топология
Callback API
RESTful API
Прямое устройство
(a) SDK
(X) Публичный IP
Полный
Полный (в рамках SDK)
Непрямое устройство
(a) SDK
(Y) Hybrid Connector
Полный
Полный (в рамках SDK)
Прямая БД
(b) Чтение из БД
(X) Публичный IP
Только посещаемость
Не поддерживается
Непрямая БД
(b) Чтение из БД
(Y) Hybrid Connector
Только посещаемость
Не поддерживается
Прямой файл
(c) Файл
(X) Публичный IP
Только посещаемость
Не поддерживается
Непрямой файл
(c) Файл
(Y) Hybrid Connector
Только посещаемость
Не поддерживается
Какой режим выбрать? Если у вашего устройства не от Cams есть SDK, поддерживаемый шлюзом, выберите режим SDK устройства (a) для полного доступа к API. Если нет, данные о посещаемости всё равно будут поступать через чтение из БД (b) или обработку файла (c). Для топологии выбирайте непрямую (Y) с Hybrid Connector, если не можете настроить публичный IP, — её проще всего развернуть.
Ограничения оборудования могут дополнительно сужать функции API. Даже в режиме SDK устройства отдельные API могут не работать в зависимости от прошивки модели или возможностей SDK. Всегда тестируйте на своём оборудовании и уточняйте у службы поддержки Cams.