Files
buryan-infra/ops/yandex/YANDEX-API-STATUS.md
buryan-agent d967d4ed3f 2FA включён, Gitea прибран, README-индекс, статус Яндекс API
Authentik: стадия MFA Validation переведена в режим configure с TOTP —
при входе пользователь без устройства проходит настройку по QR. Откат
описан в ops/auth/2FA.md.

Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks,
главному репозиторию задано описание и темы. README переписан как индекс:
карта инфраструктуры, ссылки на все разделы документации, принципы.

Яндекс: зафиксирован статус — чтение работает, управление через API 403
(нет scope iot), управление голосом и Zigbee работают.
2026-10-20 23:32:33 +03:00

52 lines
2.3 KiB
Markdown

# Яндекс Умный дом: статус API
## Итог
| Способ | Статус | Комментарий |
|---|---|---|
| Чтение устройств (`api.iot.yandex.net/v1.0/user/info`) | ✅ работает | 23 устройства в аккаунте |
| **Управление через API** | ❌ **403** | токен без scope `iot` |
| Управление голосом (`!алиса …`) | ✅ работает | через колонку, Алиса сама выполняет |
| Прямое управление Zigbee | ✅ работает | YNDX_00532 в HA, без облака |
## Что именно проверено
```
POST api.iot.yandex.net/v1.0/devices/actions
Authorization: OAuth <music_token> → 403 Forbidden
Authorization: OAuth <x_token> → 403
Authorization: Bearer <x_token> → 403
POST iot.quasar.yandex.ru/m/user/devices/{id}/actions
Cookie → 401
Cookie + x-token → 401
Cookie + x-csrf-token → 401
x-token → 401
```
Переавторизация YandexStation по QR обновляет cookie, но `x_token` остаётся
прежним и прав на запись не даёт. Второй экземпляр интеграции HA не разрешает
(поток завершается `abort`).
## Рабочий способ управления — голос
```
!алиса включи свет в тамбуре
!алиса выключи телевизор в детской
!алиса я ухожу
!алиса какая погода
```
Бот отправляет на колонку «Алиса, …», и она выполняет. Работает для всех
устройств и сценариев аккаунта, не только для тех 18, что попали в мост.
## Как включить прямой API (если понадобится)
1. Взять OAuth-токен с scope `iot` (приложение «Дом с Алисой» /
Яндекс Ключ → Интеграции).
2. Положить в `/root/.yandex-mtoken`.
3. Перезапустить `yandex-iot-bridge` — он уже умеет `on_off`,
`brightness`, `rgb`.
Проверка: `POST /v1.0/devices/actions` должен вернуть 200.