Интеграции¶

https://cloud.kavlev.ru/integrations.html?project=<id> — admin / owner.

Здесь подключаются голосовые ассистенты и внешние брокеры. Привязка одна — устройства, попавшие в Smart Home конкретного провайдера, видны во всех — Алисе, Марусе, Салюту через unified модель.

Список интеграций¶

Провайдер	Статус	OAuth client	Действия
Яндекс Алиса	Connected / Disconnected	`yandex.smart-home.<your-id>`	Linked accounts / Disconnect
Маруся	Connected / Disconnected	`marusya.<your-id>`	Linked accounts / Disconnect
Сбер Салют	Connected / Disconnected	`sber.<your-id>`	Linked accounts / Disconnect
MQTT (Phase Broker)	Enabled / Disabled	—	Config

Яндекс Алиса¶

См. Интеграции → Яндекс Алиса для пошагового гайда.

Состояние «Connected» означает что в oauth_clients таблице есть запись с вашим Yandex-skill OAuth-client'ом и хотя бы один пользователь сделал linking (Алиса знает токен для запросов в облако).

Linked accounts — это аккаунты Яндекса, привязанные к этому проекту. У одного проекта может быть несколько привязок (если несколько человек завязали свои Yandex-аккаунты на этот проект).

Disconnect — отзывает OAuth-grant у всех linked accounts. Алиса перестанет видеть устройства до новой привязки.

Маруся и Сбер Салют¶

Те же эндпоинты Smart Home, разные OAuth-flow'ы. Технически — отдельные oauth_client-записи с разным redirect_uri и приложением.

Подробнее — Интеграции → Маруся и Салют.

MQTT (Phase Broker)¶

Альтернатива HTTP-heartbeat'у. Если включено — плата подписывается на MQTT-топик и получает команды push'ем.

Поле	Назначение
Broker URL	`mqtts://emqx.cloud.kavlev.ru:8883`
Topic prefix	`kavlev/<project_id>/<device_uuid>`
Credentials	Сгенерированные username/password для конкретной платы

Плюсы MQTT: задержка команды — мс, а не секунды (heartbeat-interval).

Минусы: ещё одно соединение (TLS-handshake, keep-alive). На ESP8266 с активным mesh могут быть проблемы с RAM.

Подробнее — Интеграции → MQTT (Phase Broker).

API за этой страницей¶

См. API → Integrations.