Files
buryan-infra/ops/media/YANDEX-TOKEN.md
T
buryan-agent e7bd6e5f0c Токен Яндекса: вставка целой ссылки и проверка перед сохранением
Страница /yandex.html переписана: два способа получения токена (OAuth-ссылка и
Network-вкладка), вставка целого адреса — токен извлекается регуляркой.

POST /yandex/save: добавлен в do_POST (раньше был только в GET-цепочке, форма
получала «нет такого пути»). Перед сохранением токен проверяется через
account/status; 401 или гостевой аккаунт (без uid) — не сохраняется.

Ловушки: гостевой ответ API — 200 без uid; текстовые правки core.py рвут
синтаксис, если срезать скобку.
2026-10-20 13:50:01 +03:00

60 lines
3.4 KiB
Markdown

# Как получить токен Яндекс Музыки
Страница: **https://status.buryans.ru/hub/yandex.html**
Пароль и второй фактор никуда не передаются — только токен, и он
проверяется перед сохранением.
## Способ 1: ссылка (быстрее)
1. Открыть https://oauth.yandex.ru/authorize?response_type=token&client_id=23cabbbdc6cd418abb4b39c32c41195d
(кнопка на странице).
2. Войти, нажать «Разрешить».
3. Браузер перейдёт на адрес вида
`https://music.yandex.ru/#access_token=eyJ...&token_type=bearer&expires_in=...`
4. **Скопировать весь адрес из строки браузера.**
5. Вставить на странице — токен вытащится автоматически (регулярка по
`access_token=`).
## Способ 2: из браузера (если первый не сработал)
1. Открыть music.yandex.ru, войти.
2. F12 → вкладка **Network** → фильтр `api.music.yandex.net` → F5.
3. Кликнуть любой запрос → **Headers** → **Request Headers** →
`Authorization: OAuth eyJ...`
4. Скопировать всё после `OAuth` (обычно начинается с `y0_` или `eyJ`).
5. Вставить на странице.
## Что происходит при сохранении
1. `POST /yandex/save` — принимает и голый токен, и целую ссылку.
2. Токен извлекается (`access_token=...`), проверяется через
`GET api.music.yandex.net/account/status`.
3. Если Яндекс вернул **401** или **гостевой аккаунт** (без `uid`) — токен
**не сохраняется**, показывается ошибка.
4. Если всё хорошо — `/root/.yandex-token` (права 600), сразу видно логин и
наличие Плюса.
## Проверка
```bash
python3 /opt/hub-core/yandex_music.py --check
python3 /opt/hub-core/yandex_music.py --likes # метаданные «Мне нравится»
python3 /opt/hub-core/yandex_music.py --download 5 # личное офлайн-прослушивание
python3 /opt/hub-core/yandex_music.py --m3u # плейлист для Navidrome
```
Дальше ночная синхронизация в 05:30 делает это сама.
## Ловушки
* **Гостевой ответ.** `account/status` без токена отдаёт **200** и гостевой
аккаунт (region 225), а не 401. Поэтому проверка идёт по наличию `uid`,
иначе любой мусор выглядел бы валидным.
* **`/yandex/save` в GET-цепочке.** Первая версия повесила маршрут в
`do_GET`, а форма шлёт POST — сервер отвечал «нет такого пути». Теперь
обработчик есть и в `do_POST`.
* **Незакрытая скобка.** Правка `yandex_save` через текстовую замену срезала
`}` в `return {...}` — ядро перестало запускаться. Восстановлено; при
текстовых правках надо сразу проверять `ast.parse`.