Интеграция со Spotify без кода: плеер, плейлисты и поиск музыки

Интеграция со Spotify в nana800 - это блок, который управляет плеером, ищет треки, альбомы, исполнителей и плейлисты, создаёт плейлисты и добавляет в них треки. Для подключения нужен токен доступа из своего приложения в Spotify for Developers, а для управления плеером ещё и аккаунт Spotify Premium. Каждое действие стоит 0,20 ₽, а баланс каждый месяц бесплатно пополняется до 350 ₽.

Собрать в конструкторе
  • Запуск блока: 0,20 ₽
  • Бесплатно каждый месяц: 350 ₽
  • Карта не нужна

Что можно сделать

  • Включать музыку, ставить на паузу, переключать треки, менять громкость и добавлять трек в очередь (нужен Spotify Premium)
  • Узнавать, что играет сейчас, и получать недавно прослушанные треки
  • Искать треки, альбомы, исполнителей и плейлисты, в том числе с уточнениями вроде artist:Queen year:1975
  • Создавать плейлисты, добавлять в них треки на нужное место и удалять треки
  • Получать данные трека, альбома и исполнителя, альбомы исполнителя, свои плейлисты и их треки
  • Читать любимые треки и список исполнителей, на которых вы подписаны
  • Принимать трек ссылкой open.spotify.com, URI или ID, например из сообщения в Telegram-бот

Блоки в конструкторе

  • Действие в Spotify

    Действие · 0,20 ₽ за запуск

    Одна операция на выбор: плеер, треки, альбомы, исполнители, плейлисты или библиотека. Работает с токеном доступа вашего приложения Spotify, который живёт 1 час. Возвращает найденный объект или список и общее число результатов.

Как настроить

  1. 1

    Создайте приложение Spotify

    Откройте Spotify for Developers и нажмите Create app. Укажите любой адрес возврата (Redirect URI), например http://127.0.0.1:8888/callback. В разделе User Management добавьте почту своего аккаунта Spotify: в режиме разработки приложением могут пользоваться только добавленные люди, до 5 человек.

  2. 2

    Получите токен доступа

    Получите токен через авторизацию Authorization Code: Client ID и Client Secret лежат в настройках приложения. Запросите права на плеер, плейлисты и библиотеку, полный список прав есть в инструкции блока в конструкторе. Токен живёт 1 час.

  3. 3

    Добавьте блок Spotify

    Создайте схему в конструкторе и добавьте блок «Spotify». Вставьте токен в поле «Токен доступа» и выберите операцию, например add_to_playlist. Укажите плейлист и трек: подойдёт ссылка open.spotify.com, URI или просто ID. Позицию можно не заполнять, тогда трек встанет в конец плейлиста.

  4. 4

    Включите схему и проверьте кнопкой

    Добавьте триггер «button», включите схему и нажмите кнопку. Откройте плейлист в Spotify или результат блока: при ошибке в error_message будет пояснение, например что токен истёк. Кнопка бесплатная, платится только запуск блока Spotify.

  5. 5

    Настройте обновление токена

    Если схема должна работать дольше часа, поставьте перед блоком Spotify блок «request», который получает у Spotify новый токен по refresh token: его Spotify выдаёт вместе с первым токеном. Новый токен из ответа этого блока подставьте в поле «Токен доступа».

  6. 6

    Поставьте рабочий триггер

    Поставьте нужный триггер, например «Telegram message from user to bot», чтобы гости присылали боту ссылки на песни для общего плейлиста, и оставьте схему включённой. Пока она включена, она стоит 0,42 ₽ в час.

Частые вопросы

Каждая операция блока стоит 0,20 ₽: поиск, добавление трека, пауза и любая другая. Включённая схема стоит 0,42 ₽ в час. Баланс каждый месяц бесплатно пополняется до 350 ₽, карта не нужна. Если схема включена круглосуточно весь месяц, большая часть этой суммы уходит на часы её работы.

Создайте приложение в Spotify for Developers, добавьте свою почту в User Management и получите токен через авторизацию Authorization Code с Client ID и Client Secret приложения. Токен живёт 1 час, потом блок вернёт ошибку о просроченном токене. Если Spotify отвечает Forbidden, проверьте, что ваш аккаунт добавлен в User Management, а у владельца приложения есть Premium.

Плеером можно управлять только с аккаунтом Spotify Premium и когда Spotify открыт на каком-нибудь устройстве, например на телефоне или компьютере. Ещё проверьте, что у токена есть права user-read-playback-state и user-modify-playback-state.

Spotify закрыл для новых приложений get_audio_features, get_related_artists, get_new_releases и get_artist_top_tracks. У старых приложений с расширенным доступом они могут работать, иначе блок вернёт ошибку с пояснением. Замена: для новинок search_albums с запросом tag:new, для лучших треков исполнителя search_tracks с запросом artist: и имя.

Поиск отдаёт не больше 10 результатов за запрос, по умолчанию 5. Остальные списки, например треки плейлиста или любимые треки, до 50. Чтобы получить следующие, заполните поле «Пропустить результатов»: 10 при лимите 10 покажет результаты с 11 по 20. Треки плейлиста Spotify отдаёт только для ваших плейлистов и тех, где вы соавтор.

Соберите первую схему бесплатно

Регистрация бесплатная, карта не нужна. Каждый месяц баланс бесплатно пополняется до 350 ₽, этого хватает примерно на 3 500 запусков простых блоков.

Собрать в конструкторе