Как работает интеграция

Обновлено 22 декабря 2024

Реализация интеграции требует разработки: вам понадобится развернуть OAuth2-сервер для авторизации и создать бридж, который будет преобразовывать запросы умного дома Sber в запросы API вашей системы и возвращать ответ. Кроме того, бридж может отправлять запросы в API умного дома Sber в согласованном формате — это не обязательно, но мы рекомендуем реализовать тоже.

Интеграция становится доступной пользователям после модерации. Чтобы управлять вашими устройствами через умный дом Сбер, пользователь должен в приложении Салют для Android, веб-версии приложения Салют или приложении СберБанк Онлайн связать  свой Сбер ID с аккаунтом в вашей системе: выбрать ваш умный дом и ввести пароль от него. При успешной авторизации генерируется access-токен пользователя — с ним умный дом Sber будет отправлять запросы в ваше облако.

Затем умный дом запрашивает у вашего облака список устройств пользователя и импортирует их: устройства начинают отображаться в приложении Салют для Android, веб-версии приложения Салют, приложении СберБанк Онлайн, а также на SberPortal, SberBox и других устройствах с ассистентом Салют. Пользователь может ими управлять.

Пример управления устройством:

1. Пользователь в приложении Салют выключает вашу лампу.
2. Приложение Салют передает команду в умный дом Sber.
3. Умный дом использует access-токен пользователя и транслирует команду в ваше облако.
4. Бридж преобразует полученную команду в формат API вашей системы.
5. Ваш API отправляет команду на устройство. Лампа гаснет.
6. Ваш API через бридж возвращает в умный дом Sber новое состояние устройства («выключено»).
7. Умный дом меняет статус лампы: она отображается как выключенная в приложении Салют, приложении СберБанк Онлайн и на устройствах с ассистентом Салют.