
Интеграция замков с приложением, PMS или платформой управления зданием выполняется с помощью двух отдельных наборов инструментов: облачных API для удалённого управления и Bluetooth SDK для управления с телефона вблизи. Путать их — самая распространённая ошибка при планировании интеграции.
Когда стороннему приложению необходимо управлять умными дверными замками — каналу аренды, выпускающему коды, офисной платформе, добавляющей посетителей, или гостиничному приложению, выдающему мобильные ключи, — производитель замков предоставляет программируемые интерфейсы на двух уровнях. Облачный API обычно представляет собой REST-сервис, работающий по HTTPS: приложение проходит аутентификацию с помощью учётных данных в стиле OAuth, создаёт коды доступа или электронные ключи, отправляет команды удалённой разблокировки для подключённых замков, запрашивает состояние замков и получает webhook-уведомления о разблокировке, низком заряде батареи и вскрытии. Мобильный SDK — это библиотека, встроенная в собственное приложение интегратора для iOS или Android, которая обеспечивает обнаружение Bluetooth, безопасное подключение, разблокировку вблизи и автономную работу с учётными данными без обращения к серверу. Успешные интеграции осознанно используют оба уровня, защищают свои учётные данные и до запуска тестируют ограничения частоты запросов и доставку событий. Это руководство описывает ключевые концепции и вопросы к производителю, которые имеют значение. Доступность API и SDK, их области действия и лицензирование для каждой платформы подтверждаются в письменной форме в рамках каждого коммерческого предложения.
| Облачный API | Сервисы HTTPS управляют замками, учётными данными и событиями с сервера; удалённый доступ к дверям возможен только при подключении замков через Wi-Fi или шлюз. |
| Мобильный SDK | Встроенные библиотеки iOS/Android обеспечивают подключение Bluetooth, разблокировку вблизи и автономную логику внутри собственного приложения интегратора. |
| Аутентификация | Учётные данные клиента в стиле OAuth, токены с ограниченной областью действия и подписанные webhooks отделяют профессиональные платформы от открытых скриптов ретрансляции. |
| Учётные данные для каждого API | Типичные операции позволяют создавать коды доступа с ограниченным сроком действия, электронные ключи, карты и ссылки для посетителей, а также просматривать, обновлять и отзывать их через соответствующие конечные точки. |
| Доставка событий | Webhooks уведомляют о разблокировке, использовании кода, низком заряде батареи и событиях двери; поведение при повторных попытках и гарантии порядка должны быть задокументированы. |
| Зависимость от оборудования | Удалённые команды выполняются только на подключённых замках через Wi-Fi или шлюз, поэтому проектирование API и аппаратной топологии необходимо вести совместно. |
| Наша политика | Мы предоставляем документацию по интерфейсам, песочницу или тестовые устройства, а также технический контакт; производственные учётные данные и ограничения определяются соглашением с платформой. |
Серверная автоматизация (каналы аренды, PMS, управление посетителями) строится на облачном API; брендированные мобильные приложения с управлением вблизи или в автономном режиме дополняются мобильным SDK. Для продуктов, которым нужны оба решения, модель учётных данных следует определить до написания кода.
| Цель интеграции | Основной набор инструментов | Ключевая зависимость |
|---|---|---|
| Выпуск арендных кодов с ограниченным сроком действия | Облачный API из системы бронирования | Замки должны поддерживать нужный тип кода и способ синхронизации. |
| Брендированное приложение для арендаторов | Мобильный SDK и облачный API | Команда приложения отвечает за выпуск SDK и проверку в магазине приложений. |
| Выдача мобильных ключей в отеле | События облачного API из промежуточного ПО PMS | Сервис учётных данных и покрытие шлюзами на входах. |
| Киоск управления посетителями | Облачный API для одноразовых учётных данных | Часовые пояса и правила истечения срока действия следует проверить заранее. |
| Онлайн-консьерж с удалённым доступом | Разблокировка через облачный API и подтверждение через webhook | Только подключённые замки мгновенно выполняют удалённые команды. |
| Офлайн-корпоративный кошелёк | Мобильный SDK с защищёнными локальными учётными данными | Правила хранения ключей и их отзыва на устройстве. |
API сталкивается с физической реальностью при открытии дверей: шлюзы, металлические двери и режим работы батареи определяют, успеет ли чистый вызов API дойти до замка вовремя. Пилотное оборудование и программное обеспечение следует тестировать вместе.
| Вход | Типичная дверь | Подход к замку |
|---|---|---|
| Дверь арендного объекта | Замок Bluetooth с отдельным шлюзом для каждой зоны | Система бронирования создаёт офлайн- и онлайн-коды через облачный API. |
| Стеклянный вход в офис | Подключённый считыватель или контроллер | Платформа посетителей отправляет одноразовые учётные данные и получает webhook-уведомления о входе. |
| Гостиничный номер | Замок RFID с сервисом мобильных ключей | Промежуточное ПО PMS вызывает API ключей; шлюз передаёт обновления в реальном времени. |
| Дверь коворкинга | Умный дверной замок за стеклянным фасадом | Приложение для участников встраивает SDK для разблокировки вблизи даже при слабом сигнале Wi-Fi. |
| Ворота логистического объекта | Наружный подключённый замок | Удалённые команды требуют подтверждённого подключения и резервных контактов. |
| Помещение дополнительных услуг | Замок на батарейках с удалённым управлением | Аудит через webhooks обеспечивает выставление счетов и проверку злоупотреблений в приложении оператора. |
API могут выглядеть одинаково в презентациях, но различаться в промышленной эксплуатации. До того как направлять ресурсы инженерной разработки, интеграторам следует собрать приведённые ниже материалы; мы помогаем координировать их получение с командой платформы.
| Компонент | Типичная логика | Примечания |
|---|---|---|
| Справочник API | Конечные точки, области действия, версии и доступность песочницы. | Оценки трудозатрат инженерной разработки зависят от полной и актуальной документации. |
| Пакет SDK | Поддерживаемые версии ОС, примеры приложений и периодичность выпусков. | Необходимо понимать требования к публикации в магазинах приложений и модели сопровождения. |
| Модель безопасности | Типы токенов, ротация секретов, подписание webhooks и варианты ограничения по IP. | Защита конечных точек разблокировки является обязательным требованием для промышленной эксплуатации. |
| Лимиты и квоты | Ограничения частоты запросов, разбиение на страницы, пакетные операции и правила повторных попыток. | Иначе запуск парка замков может завершиться сбоем в часы пикового заезда. |
| Каталог событий | Типы событий, полезные данные, порядок обработки и гарантии повторной доставки. | Функции аудита и уведомлений зависят от надёжной доставки событий. |
API — это серверный интерфейс для взаимодействия между серверами: ваша серверная система вызывает платформу замков по HTTPS, чтобы создавать коды, отправлять команды разблокировки на онлайн-замки, запрашивать их статус и получать события через webhook. Он работает независимо от proximity телефона. Мобильный SDK — это программная библиотека, встроенная в ваше собственное приложение для iOS или Android, которая взаимодействует с замками напрямую по Bluetooth, обеспечивая разблокировку рядом с замком, настройку и офлайн-хранилище учетных данных, когда сервер недоступен. Серверные системы для аренды и интеграции с PMS обычно нуждаются в облачном API, а брендированные приложения для арендаторов, как правило, требуют SDK и отдельных вызовов API. Попытка выполнять все действия только через API — например, разблокировать замок, поддерживающий исключительно Bluetooth, из другой точки мира без шлюза — просто не сработает, поэтому аппаратную топологию и выбор интерфейса необходимо проектировать совместно. Доступные интерфейсы для каждой платформы подтверждаются в письменной форме в рамках коммерческого предложения.
Да, это стандартный сценарий интеграции: после подтверждения бронирования ваша серверная система или промежуточное ПО вызывает API платформы замков, передавая номер комнаты или объекта, даты заезда и выезда, и получает код доступа или ekey, который доставляется гостю через ваш собственный шаблон сообщения или электронной почты. Затем webhook подтверждают использование кода и сообщают о таких событиях, как попытка раннего заезда или низкий заряд батареи. Необходимо заранее определить обработку часовых поясов для временных периодов, тип кода, который работает офлайн на выбранных замках, покрытие шлюзами для оперативной отзыва прав, идемпотентность повторных попыток при повторной отправке сообщений, а также порядок обновления учетных данных при отменах и изменениях дат. Мы предоставляем тестовые замки и поддерживаем семинары по интеграции; сведения о конечных точках, лимитах запросов и лицензировании для каждой платформы подтверждаются в письменной форме в рамках коммерческого предложения.
Удаленная разблокировка безопасна, если платформа построена как любой аутентифицированный финансовый API: токены в стиле OAuth с ограниченными разрешениями, хранение секретов на стороне сервера, отдельные права для каждого сотрудника, подтверждение команд через webhook, журналы аудита и, при необходимости, двухфакторное одобрение для доступа к чувствительным дверям. Ситуация становится опасной, когда интеграторы встраивают долгоживущие секреты в мобильные приложения, открывают релейные конечные точки или записывают URL-адреса разблокировки в журналы. Физические меры защиты также важны: удаленные команды поступают только на онлайн-замки, а для дверей с высоким уровнем безопасности удаленная разблокировка часто полностью отключается или требует двойного одобрения. В ходе проверки Due diligence запросите технический документ по безопасности, процедуру ротации токенов и схему подписания webhook, не ограничиваясь заявлением о наличии «REST API». Мы координируем такие проверки с командой платформы и можем предложить архитектуры, в которых удаленная разблокировка доступна только определенным ролям сотрудников стойки регистрации.
Webhook — это стандартный канал событий, включающий записи о разблокировке, вводе кодов, низком заряде батареи, попытках вскрытия и изменениях датчиков двери, однако семантика доставки различается в зависимости от платформы. Профессиональные платформы подписывают полезные данные, повторяют неудачные попытки доставки с увеличивающимися интервалами и предоставляют API для сверки или опроса пропущенных событий. Это важно, поскольку сети периодически выходят из строя, а повторная доставка является обычным явлением; поэтому потребители должны обрабатывать идентификаторы событий идемпотентно. Гарантии порядка событий слабее: два события, возникшие с разницей в несколько секунд, иногда могут прийти в обратном порядке, поэтому в логике аудита следует использовать временную метку события на замке, а не время его получения. Во время пилотного проекта имитируйте офлайн-приемник и проверьте поведение при повторной отправке. Каталог событий, политика повторных попыток и конечные точки для сверки выбранной платформы документируются в письменной форме до начала разработки.
Доступ к API предоставляется платформой замков в соответствии с ее собственными условиями для разработчиков и коммерческого использования, как правило, владельцу учетной записи: бренду или оператору, владеющему облачным проектом, а не автоматически каждому покупателю замка. Производитель может помочь с активацией сервиса, предоставить документацию и координировать техническое подключение, но не может предоставить права сверх условий платформенного соглашения. Некоторые платформы различают пользователей только с доступом к приложению, бизнес-аккаунты с информационными панелями и сертифицированных партнеров-разработчиков с полным доступом к API, а для нескольких расширенных конечных точек требуется одобренная проверка интеграции. Поэтому покупателям, планирующим глубокую интеграцию, следует подтвердить допуск к программе разработчиков, сборы, условия обработки данных и поддерживаемые регионы до выбора оборудования, поскольку отличный замок без прав на API не сможет обеспечить работу запланированного продукта. Текущие программы разработчиков и условия лицензирования для каждой платформы подтверждаются по запросу коммерческого предложения.
Укажите сценарии интеграции, технологический стек команды и сроки запуска в запросе коммерческого предложения. Мы координируем подготовку документации по API, пакетов SDK, тестовых устройств и соглашений с платформами, а также поддерживаем совместный пилотный проект, охватывающий офлайн-режим, повторные попытки и события в масштабе парка замков.
Запросить спецификацию и коммерческое предложениеОбзор технологийПоследнее обновление: 31 октября 2026 г. · Проверено редакционной командой Smart Lock Factory