Turnstile Gate SDK & API: Руководство по интеграции для разработчиков и системных интеграторов
2026-03-25
Турникеты Ironman поддерживают полную интеграцию SDK и API с сторонними программными системами — включая платформы для продажи билетов, Системы посещаемости HR, Инструменты управления посетителями, и системы управления зданиями. В этом руководстве рассказывается, что содержит пакет SDK для турникетных ворот, какие типы API поддерживаются, и как протестировать живое соединение с помощью Postman. Если вы разработчик или системный интегратор, оценивающий поставщика турникетов, Это техническая справка, которая вам нужна перед принятием решения.
Для облачных развертываний, см. нашОблачные системы турникетных ворот — эти модели включают нативную поддержку API из коробки.
SDK против. API — Что каждый из них делает для интеграции турникетов
SDK с турникетным воротом и API выполняют разные роли в процессе интеграции. Понимание различия экономит время на настройке и предотвращает наиболее распространённые технические недоразумения при начале нового проекта.
ТемSDK — это полный пакет разработки. Включает документацию, Образцы кода, Технические характеристики проводки, Интерфейсная плата, и тестовые утилиты. SDK вы используете на этапе настройки и сборки — до запуска программного обеспечения.
ТемAPI — это командный интерфейс, который ваше программное обеспечение вызывает во время работы в реальном времени. Каждый раз, когда пользователь предъявляет учетные данные на входе, ваша платформа отправляет API-запрос, и контроллер турникета отвечает результатом.
| SDK | API | |
|---|---|---|
| Что это такое | Полный пакет разработки | Интерфейс команд и данных |
| Кто им пользуется | Разработчик во время настройки | Программное обеспечение во время работы в реальном времени |
| Что он содержит | Документы, Образцы кода, Интерфейсная плата, Тестовые инструменты | Конечные точки, параметры, Форматы ответов |
| Когда это понадобится | Этап интеграции и тестирования | Каждая транзакция на гейте после запуска |
Подумайте об этом так: SDK — это то, что вы используете для построения соединения.. API — это то, что запускает его после этого.
Что содержит пакет SDK Turnstile Gate от Ironman
Когда вы запрашиваете SDK-пакет у Ironman, Вы получаете больше, чем просто документацию. Пакет охватывает всё, что нужно разработчику для завершения рабочей интеграции с первого дня.
Документация и файлы спецификаций
Пакет документации включает:
- Спецификация аппаратного протокола: Определяет формат связи для Wiegand 26 и 34 бит, Серия RS485, и выходы реле с сухим контактом
- Ссылка на конечную точку API: Полный список командования, Определения параметров, и описания кодов ответа
- Схема электропроводки: Расположение соединения интерфейсной платы API с управляющим портом затвора
- Поддерживаемые типы учетных данных: RFID, QR-код, биометрический (Выход Виганда с терминала), и ввод PIN-кода
Каждый документ поставляется вместе с аппаратным заказом. Если вашему проекту требуется индивидуальное сопоставление учетных данных или нестандартные протоколы, Инженерная команда Ironman проверяет требования перед отправкой.
Программные инструменты и примеры кода
Программный уровень SDK включает:
- Интерфейсная плата API: Физический аппаратный компонент, который соединяет контроллер турникета с вашей программной средой (Локальный сервер, Облачная конечная точка, или локальный ПК)
- Примеры кода: Предоставляется на распространённых языках, основанных на вашей платформе проекта — включая примеры интеграции для обработки запросов HTTP POST
- Утилиты для тестирования: Используется для проверки успеха вызова API перед подключением к производственной системе
- Прямая IT-поддержка: Техническая команда Ironman помогает с конфигурацией тестов Postman и подтверждает первый вариант 50 Живые транзакции во время ввода в эксплуатацию
По нашему опыту внедрения интеграций API для проектов на площадках и транспорте, Интерфейсная плата и документация вместе решают 90% вопросов по интеграции до того, как потребуется единая заявка в поддержку.
Типы API, поддерживаемые Ironman Turnstile Gates
Турникетные ворота Ironman поддерживают три основных пути интеграции API. Правильный вариант зависит от архитектуры вашего программного обеспечения, Сетевая среда, и тип квалификации.
REST API (На основе HTTP)
REST API — самый распространённый путь интеграции для современных программных платформ. Ваше приложение отправляет HTTP POST или GET запросы на конечную точку API турникета. Контроллер отвечает JSON-полезной нагрузкой — учётная информация валидна/недействительна, Состояние открытого/закрытого затвора, и временную метку события.
Этот путь подходит для SaaS-платформ для продажи билетов, Веб-системы HR-посещаемости, и облачные инструменты управления посетителями. Для этого требуется сетевое соединение между вашим сервером и интерфейсной платой турниклета — либо LAN, либо интернет, в зависимости от модели.
SDK + Интерфейсная плата (Аппаратно-программный мост)
Для сред без сетевого подключения — включая офлайн-объекты, Зоны безопасности с воздушным разрывом, или устаревшие локальные ERP-системы — интерфейсная плата подключается напрямую к локальному серверу или ПК через RS485 или RS232.
SDK предоставляет драйверы и библиотечные файлы, необходимые вашему серверу для чтения сигналов гейта и записи решений о доступе обратно на контроллер. Этот путь распространён на производственных предприятиях и корпоративных кампусах с локальными HR-системами.
Программный слой протокола Виганда
Когда считыватели учетных данных выводят 26- или 34-битные сигналы Wiegand, SDK предоставляет библиотеку парсеров, которую ваше программное обеспечение использует для интерпретации этих сигналов. Это особенно актуально для систем HR-обслуживания, где считыватели RFID-карт уже подключены к контроллеру турникета.
Wiegand фактически является отраслевым протоколом с 1960-х годов и остаётся самым широко установленным аппаратным стандартом связи в существующих системах контроля доступа.
Пошаговый процесс интеграции API
Завершение интеграции SDK API с турникетом проходит по чёткому шестиэтапному процессу. Большинство проектов выходят в эксплуатацию в течение 48–72 часов после получения пакета SDK, при условии, что целевая платформа имеет активный API.
Шаги 1–3: Настройка и подключение
Шаг 1 — Запросить ваш SDK-пакет: Свяжитесь с Ironman, сообщите спецификации вашего проекта — модель ворот, Тип квалификации (QR-код, RFID-карта, Биометрический терминал), и вашей целевой программной платформе. Инженерная команда подтверждает совместимость и отправляет посылку.
Шаг 2 — Получить пакет SDK: Плату интерфейса API вы получаете по почте, а файлы документации — по электронной почте. Перед открытием шкафа затвора проверьте опору API и схему проводки.
Шаг 3 — Подключить интерфейсную плату: Подключите интерфейсную плату к управляющему порту турникета с помощью схемы проводки. Включите систему и убедитесь, что индикаторы состояния светодиодов на плате показывают живое соединение.
Шаги 4–6: Тестирование и запуск
Шаг 4 — Настроить конечную точку API: Настройте программное обеспечение так, чтобы HTTP-запросы отправлялись на локальный IP-адрес интерфейсной платы (для локальных установок) или облачная конечная точка (для моделей, связанных с облаком).
Шаг 5 — Тест с почтальоном: Загрузите справочный документ API в Postman. Создайте тестовый POST-запрос с примерной полезной нагрузкой учетных данных — например,, QR-кодовую строку, которую генерирует ваша система тикетов. Отправьте запрос и убедитесь, что гейт ответит ожидаемым результатом JSON. IT-команда Ironman может напрямую проверить вашу конфигурацию Postman и проверить результаты тестов при необходимости.
Шаг 6 — Подключитесь к вашей производственной системе: После прохождения тестов Почтальона, Направьте ваше живое программное обеспечение на тот же конечный конец. Следите за первым 50 Реальные транзакции до удаления тестовой среды. После конфирмации, Интеграция готова к производству.
Распространённые сценарии использования и совместимые программные системы
Turnstile gate SDK API поддерживает широкий спектр программных платформ в различных отраслях. Это четыре наиболее распространённых сценария развертывания, которыми занимается инженерная команда Ironman.
- Продажа билетов и управление площадкой: QR-код на телефоне пользователя или распечатанный билет сканируются на выходе. API отправляет QR-строку на платформу для тикетов, который возвращает корректный/неверный ответ. Врата открываются только при допустимом ответе. Используется на стадионах, Концертные площадки, Выставочные залы, и тематические парки.
- Посещаемость HR и учет времени: RFID-карта или сканирование отпечатков пальцев вызывает API-вызов в HR-систему. Система фиксирует время ввода, Удостоверение сотрудника, и Гейт Лейн. Используется на производственных предприятиях, Логистические центры, и корпоративные офисы.
- Системы управления посетителями (ВМ): Заранее зарегистрированный посетитель получает одноразовый QR-код по электронной почте. При сканировании у ворот, API проверяет код на VMS и уведомляет хост. Регистрация на ресепшене не требуется.
- Системы управления зданиями (BMS): Гейт подключается через RS485 к контроллеру BMS. Статус ворот, Количество проходов, а сигнальные сигналы в реальном времени поступают на панель управления здания.
Для корпоративных платформ, таких как Lenel, Genetec, Бриво, или Honeywell Pro-Watch, подтвердить путь API (REST или RS485 SDK) с командой Ironman перед уточнением — совместимость зависит от версии платформы.
ДляРазвертывание турникетов безопасности на полной высоте в государственных или учреждениях с высоким уровнем безопасности, Действует тот же SDK — интеграционный слой не меняется в зависимости от форм-фактора элемента затвора.
Справочник по аппаратному протоколу для разработчиков
Выбор правильного аппаратного протокола — первое решение в любом проекте интеграции. В этой таблице показаны основные протоколы, которые поддерживают ворота турникетов Ironman, Их технические ограничения, и лучший вариант использования для каждого из них.
| Протокол | Тип | Ареал | Устройства на строки | Лучший сценарий использования |
|---|---|---|---|---|
| Wiegand 26/34-бит | Скобяные изделия | ≤150 м | 1 на порт контроллера | RFID-считыватель → контроллер |
| RS485 | Сериал | ≤1 200 м | До 32 | Панель-гейт, Интеграция с BMS |
| RS232 | Сериал | ≤13 м | 1 По порту | Отладка, Обновление прошивки |
| Сухой контакт (VFC) | Скобяные изделия | Короткая дальность | Н/Д | Простое реле открытия/закрытия |
| REST API (HTTP) | Программное обеспечение | LAN/Интернет | Unlimited | Облачные билеты, ЧАС, ВМ |
| OSDP V2 | Скобяные изделия | ≤1 200 м | Множественные | Высокий уровень безопасности, AES-128 зашифрована |
Для чисто программных интеграций: REST API — правильный путь. Для аппаратно-программного мостового соединения в сетевых средах: RS485 с интерфейсной платой SDK входит в стандартную комплектацию. OSDP V2 рекомендуется для развертываний, требующих зашифрованной связи считывателя AES-128 — особенно актуально для государственных органов, здравоохранение, и точки доступа к дата-центру.
Для развертывания проектовТурникеты с умными скоростными воротами при высокопроизводительных заявках, REST API через LAN является предпочтительным способом интеграции — он обрабатывает устойчивые скорости транзакций от 40 до 60 человек в минуту на одну полосу без задержек в очереди.
Часто задаваемые вопросы
Q1: В чём разница между SDK с турникетными воротами и API?
SDK — это полный пакет разработки, который используется для создания интеграции — он включает документацию, Образцы кода, плата интерфейса API, и тестовые инструменты. API — это командный интерфейс, который ваше программное обеспечение вызывает во время работы в реальном времени. Для настройки соединения нужен SDK. Вы используете API каждый раз, когда гейт обрабатывает учетную запись после запуска.
Q2: Поддерживает ли SDK Ironman Turnstile Gate с QR-кодом и биометрической интеграцией??
Да. SDK поддерживает валидацию QR-кодов через REST API (ваша платформа для тикетов или VMS предоставляет QR-ответ), Считывание RFID-карт через Wiegand 26/34-бит, и биометрические терминалы, выводящие сигнал Виганда. Для терминалов распознавания лиц с проприетарными протоколами, Инженерная команда Ironman проверяет совместимость перед тем, как подтвердить пакет SDK.
Вопрос 3: Турникетные ворота бесплатны SDK или они стоят дороже??
Документация SDK и ссылка на API предоставляются бесплатно с подтверждёнными заказами на выходы. Плата интерфейса API — это физический аппаратный компонент, поставляемый в комплекте с элементом. Свяжитесь с командой продаж Ironman, чтобы подтвердить включение SDK для вашего конкретного заказа и объема проекта.
Q4: Сколько времени занимает завершение интеграции турникетного API?
Большинство интеграций выходят в эксплуатацию в течение 48–72 часов после получения пакета SDK, при условии, что целевая платформа имеет активный API и разработчика для тестирования. Более сложные мультигейтные или ERP-интеграции могут занять от 5 до 10 рабочих дней. IT-команда Ironman оказывает прямую поддержку на этапе тестирования, что значительно уменьшает перемещение.
Q5: Могу ли я интегрировать турникеты с существующей системой HR посещаемости или ERP??
Да. Пути RS485 и REST API SDK поддерживают интеграцию с платформами HR посещаемости и ERP-системами. Вам нужно убедиться, что у вашего ERP есть доступная конечная точка API или поддержка последовательной связи RS485. Команда Ironman может изучить документацию API вашей системы и дать рекомендации по правильному пути интеграции до заказа.
Вопрос 6: Что произойдёт, если соединение API с воротами турникета отключится?
Турникеты Ironman с встроенным хранилищем учетных данных могут продолжать работать в офлайн-режиме — контроллер использует локально кэшированные правила доступа для одобрения или отказа во входе. После восстановления соединения API, Gate автоматически синхронизирует журналы событий и любые учетные данные обновляются. Этот офлайн-резерв необходим для объектов, которые не могут принимать простои гейта во время перебоя сети.
Начало интеграции
Правильный путь интеграции сводится к трём вариантам: Ваш тип программного обеспечения (Облако или локальное использование), Тип вашей квалификации (QR-код, RFID, биометрический), и масштаб вашего объекта. Ironman предоставляет полноценный пакет SDK — интерфейсную плату, Документация протокола, Ссылка на API, и образцы кодов — с подтверждёнными приказами на ворота, плюс прямая ИТ-поддержка во время тестирования.
Глобальный рынок контроля доступа растёт при 4.08% CAGR, с турникетными воротами в центре развертывания корпоративной безопасности. Правильная интеграция программного обеспечения с первого дня защищает эти инвестиции в долгосрочной перспективе.
Запросите пакет SDK и спецификацию проекта, связавшись с командой Ironman через нашуОптовые ворота турникетов и страница проекта. Укажите требования к модели ворот, Тип квалификации, и целевую программную платформу — и ожидая технического ответа внутри 12 Часы работы.
