Нового жильца оформляют один раз — в той системе, где управляющая компания ведёт квартиры, жильцов и контактные данные. А потом заводят второй раз, уже в системе домофонии. Изменились права доступа — обновлять в двух местах. Человек съехал — удалять тоже дважды.

На одном объекте это просто лишняя работа. На портфеле зданий с постоянными заселениями, изменениями доступа и временными пропусками это превращается в отдельный административный процесс.

Что такое BAS-IP Link и Link API

BAS-IP Link — централизованная платформа BAS-IP для управления объектами, пользователями, правами доступа и подключённой инфраструктурой.

BAS-IP Link API — HTTP REST API, через который сторонняя серверная система программно взаимодействует с Link: передаёт пользователей, работает с доступом и идентификаторами, получает данные из платформы.

Смысл интеграции не в том, чтобы дать сотрудникам ещё один интерфейс. Наоборот: существующая платформа заказчика может оставаться основным рабочим инструментом, а BAS-IP становится частью процессов, которые в ней уже есть.

Как это выглядит на практике: заселение нового жильца

Управляющая компания уже знает имя жильца, его квартиру, контактные данные и другую связанную с ним информацию. Всё это существует в её собственной системе.

Без интеграции сотруднику приходится открыть BAS-IP Link и заново создать того же пользователя.

Через Link API этот этап можно автоматизировать. Основная система передаёт необходимые данные в Link, пользователь попадает в соответствующий объект и квартиру, а дальше BAS-IP Link работает с подключённой инфраструктурой.

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

Если заселение, изменение данных и выселение уже оформляются в основной платформе, эти же операции не приходится повторять вручную в системе домофонии.

Зачем Link API, если у устройств BAS-IP есть собственный API

BAS-IP поддерживает и прямую интеграцию с оборудованием через BAS-IP Device API.

Для локального проекта это может быть правильным решением. Если система должна работать с одной или несколькими заранее известными моделями оборудования и ей требуется ограниченный набор функций, дополнительный серверный уровень может быть не нужен.

Но при масштабировании задача меняется.

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

BAS-IP Link добавляет централизованный программный уровень между сторонней платформой и инфраструктурой домофонии.

Сторонняя система работает уже не вокруг конкретной панели, а с моделью пользователей, объектов, квартир, доступа и других сущностей Link.

Для системы управления недвижимостью это естественнее. Ей обычно не важно, какая именно модель панели установлена у конкретного входа. Ей важно, что определённый человек относится к конкретной квартире и должен иметь нужные права доступа.

BAS-IP Link связывает эту бизнес-логику с физической инфраструктурой.

Что доступно через BAS-IP Link API

Конкретная интеграция обычно использует только часть возможностей Link.

Через API сторонняя система может работать с:

• пользователями и структурой объектов;
• правами доступа;
• постоянными и временными идентификаторами, включая карты, брелоки, коды, QR-коды, Face ID, UKEY и номера автомобилей;
• гостевым доступом и посетителями;
• сообщениями и опросами;
• виртуальными номерами и переадресацией;
• удалённой конфигурацией оборудования;
• событиями и журналами.

Но начинать интеграционный проект лучше не со списка API-методов, а с другого вопроса:

Какие действия сегодня выполняются вручную и какие из них должны происходить автоматически после интеграции?

Для одной платформы главным сценарием будет управление жильцами. Для другой — временный доступ подрядчиков. Для третьей — получение данных о событиях.

Жизненный цикл пользователя, а не одна операция

Создание профиля — только начало процесса.

После заселения пользователю могут назначаться необходимые права и идентификаторы доступа. Если человек меняет квартиру или автомобиль, получает новые права либо теряет доступ, эти изменения также можно включить в существующий процесс основной платформы.

Та же логика работает с временными пользователями.

Если собственная система уже управляет гостями, подрядчиками или сервисными сотрудниками, нет необходимости создавать для BAS-IP отдельную административную процедуру.

Например, основная платформа может определить, что подрядчику разрешён вход во вторник с 10:00 до 14:00. BAS-IP в таком сценарии становится исполнительной частью уже существующего процесса.

В результате домофония и контроль доступа входят в общую логику объекта, а не существуют отдельно от неё.

Что делать, если объект уже работает и пользователей много

Интеграция не обязательно начинается с пустой базы.

Если в существующей системе уже есть сотни или тысячи жильцов, переносить их в BAS-IP Link вручную по одному не требуется.

При интеграции через BAS-IP Link API метод создания пользователей позволяет добавить несколько пользователей одним запросом.

Гарантированный максимальный объём одной такой операции и допустимая частота последовательных запросов не регламентированы, поэтому перед крупной миграцией эти параметры стоит проверить в тестовой среде проекта.

Детали реализации самого API-метода предоставляются партнёрам в технической документации.

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

В BAS-IP Link можно выгрузить структуру объекта в XLS-файл, заполнить таблицу данными пользователей и лицензий и загрузить её обратно. После импорта пользователи автоматически добавляются в указанные группы объекта. Если в одной квартире или другой группе должно быть несколько пользователей, для них создаются отдельные строки с одним и тем же идентификатором группы.

Для первоначального заселения необязательно собирать адрес электронной почты каждого члена семьи. Достаточно одного email на квартиру: приглашённый пользователь получает письмо, завершает регистрацию и затем может самостоятельно добавить членов семьи.

Таким образом, для действующего объекта можно выбрать автоматизированную миграцию через API или штатную массовую загрузку средствами Link — в зависимости от архитектуры проекта и того, где хранится исходная база пользователей.

Можно ли использовать события BAS-IP в другой системе

Да. Данные и события, хранящиеся в Link, могут использоваться сторонней системой.

Например, служба безопасности уже может работать в едином интерфейсе, куда поступает информация от СКУД, видеонаблюдения и других систем здания. Данные BAS-IP можно включить в тот же рабочий процесс.

Но здесь есть важное техническое различие.

На уровне BAS-IP Link сейчас нет webhooks для отправки событий сторонней системе. Необходимые данные сторонняя система получает через запросы к Link API.

Если проекту требуется получение определённых событий непосредственно от оборудования через webhooks, такой сценарий доступен на поддерживаемых Android-панелях через BAS-IP Device API.

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

Какая система должна быть главным источником данных

При интеграции важно заранее определить, какая система отвечает за каждый тип информации.

Если одного пользователя можно независимо изменять и в платформе управления недвижимостью, и в BAS-IP Link, со временем данные могут начать расходиться.

Например, основная платформа может отвечать за жильцов и квартиры, BAS-IP Link — применять эти данные к домофонии и доступу, а система безопасности — использовать необходимые события в своём интерфейсе.

В другом проекте распределение ответственности может быть иным.

Главное не в том, чтобы обязательно сделать BAS-IP или стороннюю платформу «главной», а в том, чтобы однозначно определить источник каждой сущности и направление синхронизации.

Именно это позволяет убрать дублирование, а не просто связать две базы данных.

Когда Link API особенно полезен

Link API имеет наибольший смысл там, где BAS-IP становится частью уже существующей программной экосистемы.

Это могут быть:

• платформы управления недвижимостью и жилыми комплексами;
• крупные СКУД;
• BMS и платформы управления умными зданиями;
• PropTech-продукты;
• собственные программные системы интеграторов;
• платформы, управляющие несколькими зданиями или объектами.

Чем больше пользователей, зданий и регулярных изменений доступа, тем больше операций приходится дублировать без интеграции.

Поэтому ценность Link API обычно определяется не количеством доступных API-методов, а тем, сколько отдельных процессов он позволяет объединить.

Безопасность и права интеграции

Сторонней системе не обязательно предоставлять полный административный доступ к Link.

В BAS-IP Link Self-Hosted можно создать отдельную учётную запись для интеграции и ограничить её права как по доступным функциям, так и по конкретным объектам.

Например, интеграция определённого оператора недвижимости может работать только с теми зданиями, которыми он управляет.

Авторизация выполняется с использованием токенов доступа, а обмен с API идёт по HTTPS.

Точные механизмы авторизации и структура запросов описываются в технической документации Link API.

BAS-IP Link Self-Hosted и Link Cloud

На момент публикации внешние серверные интеграции через BAS-IP Link API реализуются для BAS-IP Link Self-Hosted.

Для BAS-IP Link Cloud компания разрабатывает отдельный API-шлюз.

Поэтому если сторонняя интеграция требуется именно для проекта на Link Cloud, архитектуру стоит обсудить с BAS-IP до начала разработки.

Как начать интеграцию

Работа с Link API начинается не со списка запросов, а с описания сценария.

Например:

«Когда мы создаём жильца в нашей системе, он должен автоматически появляться в нужном объекте BAS-IP».

Этого достаточно, чтобы начать обсуждение архитектуры.

После согласования сценария партнёр подписывает NDA и получает необходимые технические материалы.

Саму интеграцию обычно разрабатывает команда партнёра. Для типового проекта чаще всего нужен backend- или fullstack-разработчик. В более крупных проектах может дополнительно потребоваться DevOps.

Для тестирования BAS-IP Link Self-Hosted можно развернуть в отдельной среде партнёра. Единого публичного sandbox для Link API сейчас нет. Условия тестовых лицензий и оборудования согласовываются в зависимости от проекта.

BAS-IP со своей стороны предоставляет документацию, отвечает на технические вопросы по своим продуктам и помогает разбираться в ситуациях, когда реализация по документации работает не так, как ожидается.

Если проект требует функции, которой в продукте пока нет, такую доработку можно обсудить с продуктовой командой. Сначала оценивается необходимый объём работы и её место в плане разработки. Такая оценка сама по себе не является обещанием конкретной даты выпуска.

Сколько времени занимает интеграция

Единого срока для всех проектов нет.

Для относительно стандартной интеграции около месяца сфокусированной разработки может использоваться как ориентир, но календарный срок часто оказывается больше.

Команде партнёра нужно разобраться в модели данных Link, реализовать свою часть интеграции, протестировать её и встроить работу в собственный план разработки.

Поэтому точную оценку имеет смысл давать только после того, как определён конкретный сценарий.

Нужно ли отдельно платить за BAS-IP Link API

BAS-IP по умолчанию не взимает отдельную плату за доступ к документации и интеграционным инструментам.

При этом сам BAS-IP Link лицензируется на обычных условиях. Разработку своей части выполняет партнёр, а нестандартные доработки или изменение приоритета работ BAS-IP при необходимости обсуждаются отдельно.

Поэтому формулировка «интеграция бесплатна» может вводить в заблуждение.

Корректнее говорить, что за доступ к интеграционным инструментам отдельная плата по умолчанию не взимается.

Когда Link API не нужен

Link API предназначен прежде всего для серверной интеграции с BAS-IP Link.

Если задача заключается в прямой работе с конкретным оборудованием или требуется получать определённые события непосредственно от панели, может быть логичнее использовать BAS-IP Device API.

Если у компании уже есть мобильное приложение и в него необходимо добавить домофонные вызовы, видео и открытие двери, для этого предназначен BAS-IP Mobile SDK.

А если достаточно совместимости по SIP, RTSP или Wiegand, полноценная программная интеграция может вообще не понадобиться.

Подробнее варианты и различия между ними разобраны в статье «Интеграция IP-домофонии BAS-IP с существующими системами здания».

Частые вопросы

BAS-IP Link API — это REST API?

Да. BAS-IP Link API — HTTP REST API для программного взаимодействия сторонней серверной системы с BAS-IP Link.

Нужен ли BAS-IP Link для работы с Link API?

Да. Link API является программным интерфейсом платформы BAS-IP Link.

Работает ли BAS-IP Link API с Link Cloud?

На момент публикации внешние серверные интеграции через Link API реализуются для BAS-IP Link Self-Hosted. Для Link Cloud BAS-IP разрабатывает отдельный API-шлюз.

Как получить документацию и нужен ли NDA?

Сначала согласовывается сценарий интеграции. После этого подписывается NDA, и партнёр получает необходимые технические материалы по Link API.

Чем Link API отличается от Mobile SDK?

Link API используется для серверной интеграции с BAS-IP Link: работы с пользователями, объектами, доступом и другими централизованными сущностями платформы.

BAS-IP Mobile SDK предназначен для другой задачи — добавления функций домофонии непосредственно в существующее мобильное приложение.

В одном проекте оба инструмента могут использоваться совместно.

Хотите интегрировать свою платформу с BAS-IP Link?

Для первого разговора не нужно заранее составлять подробную спецификацию API.

Достаточно описать существующую систему и процесс, который вы хотите автоматизировать.

Например:

«Мы создаём жильцов в собственной платформе и хотим автоматически передавать их в BAS-IP».

или:

«Мы управляем гостевым доступом в своей системе и хотим связать его с BAS-IP».

Команда BAS-IP поможет определить, подходит ли для проекта Link API, какие возможности платформы потребуются и как лучше построить интеграцию.