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

Обновлено 30 августа 2023

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

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

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

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

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