Интеграция IP-домофонии BAS-IP с существующими системами здания
На одном объекте управляющая компания работает в платформе управления недвижимостью, служба безопасности — в СКУД, а жильцы — в отдельном мобильном приложении. Если домофония остаётся ещё одной изолированной системой, одних и тех же пользователей, права доступа и события приходится вести сразу в нескольких местах.
BAS-IP можно встроить в цифровую инфраструктуру здания, которая уже используется. Управляющая платформа остаётся основным рабочим интерфейсом для персонала, а существующее приложение для жильцов получает функции домофонии и открытия двери.
Путей для этого четыре: совместимость по стандартным протоколам, BAS-IP Link API, BAS-IP Mobile SDK и BAS-IP Device API. Ниже — что подходит под какую задачу.
Что такое BAS-IP Link
BAS-IP Link — программная платформа, которая управляет подключёнными устройствами BAS-IP, объектами и квартирами, пользователями, идентификаторами доступа, вызовами и конфигурацией оборудования.
Она доступна в двух вариантах: Link Self-Hosted на сервере заказчика и Link Cloud как облачный сервис BAS-IP.
Часть интеграций работает через Link, часть — напрямую с оборудованием.
Совместимость по стандартным протоколам
Не для каждой задачи нужны разработчики. Оборудование BAS-IP работает по тем же стандартным протоколам, что и телефония, видеонаблюдение и системы контроля доступа:
- SIP — панель регистрируется как SIP-клиент на АТС заказчика, а вызовы приходят на существующие телефоны и софтфоны;
- RTSP — панель подключается к VMS или NVR как источник видео вместе с остальными камерами объекта;
- Wiegand — считыватель панели передаёт идентификатор в стороннюю систему контроля доступа.
Такие сценарии настраиваются с обеих сторон и не требуют работы с BAS-IP API или SDK.
Примечание. Для SIP-сценария необходимо заранее проверить совместимость аудио- и видеокодеков сторонней системы с конкретным оборудованием BAS-IP. Например, оборудование BAS-IP поддерживает сценарии с PCMA для аудио и H.264 для видео. Актуальный набор кодеков необходимо проверять для конкретной модели и версии прошивки.
Стандартные протоколы передают вызов, видеопоток или идентификатор, но ничего не знают о том, кто этот пользователь, в какой он квартире и какие у него права.
Если нужно работать с самими данными — заводить пользователей, выдавать и отзывать доступ, получать события, — понадобятся API или SDK.
BAS-IP Link API: интеграция с управляющей или серверной платформой
Link API подходит, когда сторонней системе нужно программно взаимодействовать с BAS-IP Link: это может быть платформа управления недвижимостью, СКУД или другая корпоративная система, которая уже используется на объекте.
Простой пример — заселение жильца.
Сотрудник создаёт профиль в своей платформе: имя, квартиру и контактные данные. Без интеграции того же пользователя заводят второй раз вручную в системе домофонии.
Через Link API данные передаются автоматически: пользователь появляется в нужном объекте и квартире в BAS-IP Link, а оттуда информация применяется к подключённой инфраструктуре BAS-IP.
Это только один из сценариев.
Через Link API сторонняя система может работать с:
- пользователями и структурой объектов;
- правами доступа;
- постоянными идентификаторами: картами, брелоками, кодами, QR-кодами, Face ID, UKEY и номерами автомобилей;
- временными идентификаторами с ограниченным сроком действия;
- гостевым доступом и посетителями;
- сообщениями для жильцов;
- виртуальными номерами и переадресацией вызовов;
- удалённой конфигурацией устройств;
- событиями и журналами.
Конкретный набор зависит от задачи.
При такой схеме основная платформа заказчика может оставаться рабочим интерфейсом его сотрудников.
Текущий статус. Интеграция сторонних серверных систем через Link API реализуется на BAS-IP Link Self-Hosted. Для BAS-IP Link Cloud такая возможность находится в разработке: доступ будет организован через API-шлюз.
Если проект планируется на Link Cloud, сценарий и доступные варианты лучше обсудить с BAS-IP до начала разработки.
BAS-IP Mobile SDK: домофония внутри собственного приложения
Второй сценарий — у компании уже есть мобильное приложение для жильцов, арендаторов или сотрудников.
В нём могут быть заявки в управляющую компанию, платежи, бронирование помещений и уведомления. Отдельное приложение только для домофонии в такой ситуации может быть избыточным.
BAS-IP Mobile SDK добавляет в существующее приложение ключевые функции домофонии и доступа, работающие через BAS-IP Link:
- авторизацию пользователя;
- приём и совершение вызовов с аудио и видео;
- просмотр видео с панели до ответа на вызов;
- push-уведомления;
- открытие двери;
- историю вызовов;
- мобильный доступ по BLE через компонент UKEY;
- вызов лифта на свой этаж.
Поддерживаются iOS и Android.
Жилец принимает вызов с панели прямо в приложении, которым уже пользуется, может увидеть посетителя ещё до ответа и открыть дверь.
Разработчику при этом не нужно строить домофонный модуль с нуля: детали SIP-коммуникации и взаимодействия с BAS-IP Link уже реализованы в готовых компонентах, а задача команды партнёра — встроить их в своё приложение.
Mobile SDK не повторяет весь функционал приложения BAS-IP Link, а даёт определённый набор готовых возможностей.
Если нужной функции в нём нет — например, генерации гостевых QR-кодов, — её можно реализовать в своём приложении через прямые вызовы Link API.
Текущий статус. Интеграция Mobile SDK выполняется на BAS-IP Link Self-Hosted. Проекты на BAS-IP Link Cloud мы рекомендуем планировать после запуска API-шлюза.
BAS-IP Device API: прямая работа с оборудованием
Не каждая интеграция требует BAS-IP Link.
Вызывные панели, внутренние мониторы и другие поддерживаемые устройства BAS-IP, включая лифтовый модуль, имеют собственный локальный API, поэтому сторонняя система может обращаться к оборудованию напрямую.
Разница простая:
Device API связывает вашу систему непосредственно с конкретными устройствами BAS-IP.
Link API связывает вашу систему с BAS-IP Link, который уже управляет подключённым оборудованием.
Прямая работа с устройствами подходит для локального проекта с ограниченным и заранее известным набором моделей.
Интеграция через Link удобнее, когда система охватывает разные модели, большое количество устройств или несколько объектов: Link снижает зависимость интеграции от особенностей отдельных моделей и их прошивок.
Доступ к Device API получить проще: документация открыта, NDA не требуется. Достаточно зарегистрироваться на портале разработчиков BAS-IP — developers.bas-ip.com — и подтвердить email.
Webhooks
Android-панели BAS-IP дополнительно поддерживают webhooks.
Внешняя система получает события в момент, когда они происходят: открытие двери, предоставление или отказ в доступе, обновление устройства и другие события журнала.
Это удобно для сценариев умного здания, где на проход или открытие двери должна реагировать другая система.
Webhooks настраиваются непосредственно на панели через конфигурацию устройства.
На Linux-панелях, мониторах и на уровне BAS-IP Link webhooks не поддерживаются.
Какой способ интеграции выбрать
| Если у вас уже есть | Обычно подходит | Основная задача |
| Телефония, VMS или СКУД | SIP, RTSP, Wiegand | Передать вызов, видеопоток или идентификатор без глубокой программной интеграции |
| Платформа управления недвижимостью, СКУД или другая серверная система | BAS-IP Link API | Связать пользователей, доступ и процессы BAS-IP с существующей платформой |
| Собственное мобильное приложение | BAS-IP Mobile SDK | Добавить вызовы, видео и открытие двери в существующее приложение |
| Локальная система с конкретными устройствами BAS-IP | BAS-IP Device API | Работать с оборудованием напрямую; на Android-панелях — в том числе получать события через webhooks |
| Серверная платформа и собственное мобильное приложение | Link API + Mobile SDK | Закрыть и серверные процессы, и пользовательские функции |
Определять подход заранее необязательно. Чаще всего он становится понятен после того, как описаны существующая система и нужный сценарий.
Что это даёт на объекте
- Быстрее первоначальная настройка: данные о пользователях и связанные с ними параметры можно передавать из системы, где они уже ведутся.
- Меньше повторного ввода: одни и те же данные не нужно заносить в несколько интерфейсов.
- Общие данные объекта: события домофонии и доступа можно собирать вместе с остальной информацией.
- Привычные рабочие процессы: персонал продолжает работать в знакомой системе, а жильцы — в одном приложении.
Чем больше объект, пользователей и связанных систем, тем заметнее эффект.
Как проходит интеграция
Компания описывает свою систему и желаемый сценарий. Например: «У нас есть приложение для жильцов, хотим принимать в нём вызовы с домофонов».
BAS-IP помогает выбрать подходящий механизм и согласовать ожидаемый результат.
Для Link API и Mobile SDK материалы передаются после согласования проекта и подписания NDA: под каждого партнёра создаётся отдельный проект с нужными спецификациями.
Документация по Device API доступна открыто.
Интеграцию разрабатывает команда партнёра. BAS-IP отвечает на технические вопросы по своим продуктам, помогает разобрать сценарий и разобраться, если реализация по документации ведёт себя не так, как ожидается.
Если для проекта требуется функциональность, которой сейчас нет в продукте, этот запрос можно обсудить с продуктовой командой BAS-IP. Сначала оцениваются объём работ и их место в плане разработки. Такая оценка сама по себе не является обещанием конкретной даты выпуска.
Условия по тестовой среде и оборудованию согласовываются под конкретный проект.
Готовое решение тестируется на стороне партнёра. После завершения партнёр демонстрирует BAS-IP результат или предоставляет описание реализованной интеграции.
Ориентиром для типовой интеграции может служить около месяца чистого времени при сфокусированной работе.
Календарно проекты обычно идут дольше: срок зависит от загрузки команды партнёра и времени на знакомство с системой.
Сколько это стоит
BAS-IP по умолчанию не взимает отдельной платы за доступ к документации и инструментам интеграции.
Лицензирование продуктов BAS-IP при этом осуществляется на обычных условиях, а дополнительные доработки или изменение их приоритета согласовываются отдельно.
Частые вопросы
Чем Link API отличается от Mobile SDK?
Link API связывает BAS-IP с серверной системой — например, платформой управления недвижимостью или СКУД. Mobile SDK добавляет функции домофонии в мобильное приложение. В одном проекте их можно использовать вместе.
Нужен ли BAS-IP Link для интеграции?
Не всегда. Многие устройства BAS-IP имеют собственный локальный API, поэтому сторонняя система может работать с оборудованием напрямую. Link обычно удобнее, когда интеграция охватывает разные модели, много устройств или несколько объектов.
Нужен ли NDA?
NDA требуется для Link API и Mobile SDK. Документация по Device API открыта.
Есть ли webhooks?
Да, на Android-панелях. Внешняя система может получать события устройства в реальном времени. На Linux-панелях, мониторах и на уровне Link webhooks нет.
Можно ли интегрировать стороннюю платформу с BAS-IP Link Cloud?
Внешние интеграции сторонних серверных систем через Link API сейчас реализуются на Link Self-Hosted. Для Link Cloud такая возможность находится в разработке.
Сколько разработчиков нужно?
Для Link API обычно нужен backend- или fullstack-разработчик. Для Mobile SDK — мобильный разработчик. Для крупных интеграций может понадобиться DevOps.
Хотите интегрировать BAS-IP со своей системой?
Расскажите, какую платформу, приложение или оборудование вы используете и какой сценарий хотите реализовать.
Команда BAS-IP поможет определить подходящий вариант: совместимость по протоколам, Link API, Mobile SDK, Device API или их комбинацию.