Разработчикам и интеграторам

Здесь — задачи для тех, кто подключает Рокет Хоум к своему коду, агенту или самодельному устройству. Владельцу дома эти страницы не нужны: начните с Основные шаги.

Вызвать API из своего приложения

Обобщённый API v2 работает по OAuth 2.0. Клиент регистрируется сам (Dynamic Client Registration, POST /oauth/register), метаданные сервера — в /.well-known/oauth-authorization-server. Доступ ограничивают scopes: rh.profile:read, rh.structure:read (локации и комнаты), rh.devices:control, rh.automations:read, rh.automations:write, rh.mqtt:connect. Пользователь может сузить scope до локации или комнаты: rh.devices:control@location:{uuid}.

Все эндпоинты, схемы и коды ответов — в справочнике API Рокет Хоум.

Подключить ИИ-агента (MCP)

MCP-сервер Рокет Хоум — https://ai.rocket-home.ru/mcp (Streamable HTTP). Агент видит структуру дома, управляет устройствами и автоматизациями от вашего имени. Вход и ключи доступа — на странице ai.rocket-home.ru через аккаунт rocket-home.ru.

Документация для агентов

Любая страница этих доков доступна в markdown: запросите её обычный URL с заголовком Accept: text/markdown или добавьте к нему суффикс .md (/docs/usage/troubleshooting.html.md). Оглавление для агентов — /llms.txt (llmstxt.org).

Получить MQTT-токен

Короткоживущий MQTT-JWT для своего клиента выдаёт GET /api/mqtt/v1/token (scope rh.mqtt:connect, основная локация пользователя); для конкретной локации — GET /api/mqtt/v1/locations/{location}/token. Постоянные логин и пароль MQTT показаны в кабинете: Настройки → MQTT.

Подключить своё устройство

Устройство, которое само публикует состояние по MQTT, подключается к облаку через открытый драйвер generic. Сквозной пример «от железа до панели» — DIY-измеритель CO₂ на ESPHome.

Автоматизировать в Node-RED

Облачный Node-RED с нодами Рокет Хоум — NodeRED + Rocket Home.

Справочники