Запрос на изменение дизайна API — поддержка публичного API UniFi Protect Alarm Manager для Arm Profile в глобальном режиме

RSS

Запрос на изменение дизайна API — поддержка публичного API UniFi Protect Alarm Manager для Arm Profile в глобальном режиме, UniFi Protect

draculabus

Guest

21.06.2026 14:19:00

Я работаю над интеграцией системы Ubiquiti в Home Assistant, и это блокируется невозможностью интегрировать Alarm Hub. Судя по документации интеграции Protect от Home Assistant, прямо сейчас сущности Alarm Manager и Alarm profile доступны только тогда, когда UniFi Protect Alarm Manager установлен в режим Local. Пока он находится в режиме Global, эти сущности не появляются, потому что профили постановки на охрану в настоящее время не предоставляются публичным API в этом режиме. UniFi Protect автоматически переключает Alarm Manager в режим Global, когда вы добавляете датчики, реле, брелоки или Alarm Hub, так что сущности сигнализации сейчас недоступны, если вы используете любое из этих устройств. @UI-Team, может кто-нибудь пожалуйста добавить это в дорожную карту для исправления?

fabiomarafioti

Guest

13.09.2026 23:50:00

У меня получилось заставить это работать как обходной путь, но это лишь подтверждает, почему Global Alarm Manager действительно необходимо добавить в поддерживаемый Protect API.Посмотрев на запросы, которые делает консоль UniFi, Global Alarm Manager сейчас предоставляет внутренние эндпоинты примерно такие:GET /api/v2/alarms/profiles

POST /api/v2/alarms/profiles/<profile-id>/actions/arm
POST /api/v2/alarms/profiles/<profile-id>/actions/disarm
Используя их, я собрал кастомную интеграцию для Home Assistant, которая теперь умеет:Читать профили тревоги Home/Away и текущее состояние постановки на охрануСтавить Home на охрануСтавить Away на охрануСнимать с охраныЧитать состояния Alarm Hub и проводных зон из ProtectТак что Global Mode технически можно управлять локально, но это недокументированные/приватные эндпоинты, и они могут измениться в любой момент. К тому же у них сейчас нет такой же чистой модели разрешений, какую можно было бы ожидать от поддерживаемого публичного API — в моём тестировании локальному аккаунту требовалось значительно больше разрешений, чем я хотел бы дать системе автоматизации.Поэтому этот обходной путь полезен, но я бы не считал его долгосрочным решением.Что было бы действительно полезно от Ubiquiti — это официальная поддержка Global Alarm Manager в Protect API, в идеале с предоставлением:Профилей тревогиТекущего профиля/состояния постановки на охрануПостановки Home / Away на охрануСнятия с охраныСостояния задержки на вход/выходСостояния Alarm Hub / зонОбновлений событий/websocket при изменении состояния тревогиОграниченного разрешения/роли, позволяющей управлять тревогой без необходимости администраторского доступаС учётом того, что Alarm Hub, датчики, брелоки и SuperLink сейчас толкают установки в сторону Global Mode, это ощущается как всё более важный пробел. Это также позволило бы Home Assistant полноценно поддерживать Global Mode, вместо того чтобы полагаться на приватные эндпоинты, которые могут исчезнуть после обновления.

rla0825 Guest	#3 13.09.2026 22:18:00 Добавляю ещё один голос за это улучшение, из-за интеграции с Home Assistant.

trevorwh Guest	#4 26.08.2026 06:10:00 Unifi Protect так классно интегрирован с Home Assistant, но теперь добавление alarm panel стало камнем преткновения из-за глобального режима и отсутствия API. Пожалуйста, добавьте это! @UI-Team тоже отмечаю здесь

l.nissen

Guest

15.08.2026 06:22:00

@UI-Team Добавляю ещё один голос к этому, с точки зрения коммерческого развёртывания на нескольких объектах. Мы используем UniFi в нескольких розничных точках и сейчас внедряем датчики входа SuperLink вместе с Protect. Как только эти датчики добавляются в систему, Alarm Manager переключается в глобальный режим, и вместе с этим сущности профилей постановки на охрану исчезают из публичного API. В итоге у нас остаются только брелок и мобильное приложение как единственный способ ставить и снимать с охраны — а это не работает для объекта, где несколько сотрудников открывают и закрывают магазин посменно. Конкретно нас блокируют две вещи: 1. В Alarm Manager нет действия «Сменить профиль сигнализации». На стороне триггеров уже всё богато — разблокировка двери, сканирование NFC, распознанное лицо — но ничто из этого не может фактически переключить состояние сигнализации. Если выставить это одно действие, это откроет большинство сценариев, которые здесь запрашивают. 2. Профили постановки на охрану недоступны через публичный API в глобальном режиме. Это более серьёзная блокировка, потому что добавление любого устройства SuperLink принудительно включает глобальный режим. Любой, кто покупает новую линейку датчиков, одновременно теряет путь для интеграции. Для коммерческого объекта нам нужно не что-то экзотическое: ввод PIN-кода (на считывателе Access или отдельной клавиатуре), который ставит и снимает с охраны, с индивидуальными кодами пользователей и журналом аудита, показывающим, кто снял с охраны и когда. Страховка и внутренние процессы оба требуют, чтобы мы могли ответить на вопрос «кто отключил сигнализацию в 05:40?» У каждого уважающего себя производителя сигнализаций это есть уже много лет. Железо явно на это способно — это пробел в софте. Есть ли какой-то из этих пунктов в роадмапе, и можете ли вы поделиться сроками? Это реально помогло бы нам решить, продолжать ли стандартизироваться на UniFi для обнаружения вторжений или запускать параллельную систему рядом. Спасибо

romfen

Guest

31.07.2026 20:17:00

Привет, та же история @UI-Team . Во-первых, отличные продукты — мне очень нравится экосистема UniFi. Главное, чего мне сейчас не хватает, — это простого способа получить глобальное состояние тревоги. Я хотел бы сделать физический индикатор (или выключатель со светодиодом), чтобы наглядно показывать, включена тревога или снята с охраны. Проблема в том, что при использовании SuperLink Alarm Manager переключается в глобальный режим, но API не предоставляет глобальное состояние тревоги. Это делает невозможным создание такой интеграции, хотя вся необходимая информация уже есть в Protect. Отдельный endpoint API, предоставляющий глобальное состояние Alarm Manager (включена/снята с охраны), был бы очень кстати. Думаю, это позволило бы создать множество полезных сторонних интеграций и кастомных аппаратных проектов. Как вариант, официальное устройство UniFi, предназначенное для отображения и управления состоянием тревоги, тоже было бы отличным дополнением. Что-то похожее на Intercom Viewer — небольшой настенный дисплей или панель состояния, показывающая текущее состояние тревоги и позволяющая включать/снимать охрану, — идеально вписалось бы в экосистему UniFi.

violuke

Guest

25.07.2026 22:28:00

Это отчаянно необходимо. Я только что установил сигнализацию Unifi и не могу использовать её с Home Assistant, хотя официальная интеграция Unifi утверждает, что могу. Я большой поклонник оборудования Unifi и дома, и на работе, но чувствую, что здесь меня здорово ввели в заблуждение.

tanelv

Guest

25.07.2026 11:58:00

Для меня это стоп-фактор для перехода на Alarm Hub. Раньше я мог переключиться обратно в локальный режим, но теперь эта опция недоступна. Мне absolutely необходимо завести это в Home Assistant, так как у меня есть продвинутая логика для определения, когда ставить и снимать систему с охраны.

almonie Guest	#9 14.07.2026 21:03:00 Привет @UI-Team, это уже в роадмапе? С выходом Alarm Hub реально нужен API-эндпоинт глобального режима, который возвращает статус и как минимум позволяет ставить на охрану. Без возможности ставить/снимать с охраны Alarm Hub без приложения Protect или дополнительного superlink и брелока — это огромная недостающая фича...

Читают тему (гостей: 6)