Платформа Radioheart AIR обладает широким набором инструментов для вывода различной информации на сайт или публичную страницу радиостанции.

При помощи готовых скриптов и виджетов наши клиенты могут добавлять на сайт различную информацию о треках в эфире станции, получать ссылки на прослушивание и/или скачивание треков из панели прямо с сайта станции, осуществлять прием заказов песен слушателями и передачу сообщений.

API предоставляется для всех клиентов хостинга по умолчанию. Набор инструментов постоянно расширяется и улучшается при участии наших клиентов.

Для полноценного использования описанных в данной статье инструментов вещание станции должно осуществляться через нашу платформу Radioheart AIR. При вещании из сторонних программ виджеты для вывода информации на сайт работать не будут.

Чтобы приступить к работе с API перейдите раздел «Приложения» в биллинге. Все инструменты для работы с API расположены в подразделах «Конструктор скриптов» и «Виджеты».

Чтобы сгенерировать код скриптов или виджетов требуется указать услугу радиохостинга. Как правило, она уже выбрана в списке.

С помощью конструктора скриптов можно сгенерировать скрипт для того, чтобы вывести на сайт станции необходимые данные — название и описание потока, количество слушателей, название текущего трека, фото исполнителя или аватар диджея.

Виджеты предназначены для интеграции на сайт нового функционала и вывода различной информации. Виджеты позволяют вывести на сайт список истории треков, предстоящих треков, новых треков, добавить на сайт прием заказов песен с возможностью передачи сообщений и топ заказов, вывести список всех треков в базе станции, а также выводить определенные треки для прослушивания или скачивания прямо на сайте станции.

Конструктор скриптов позволяет сгенерировать скрипт под ваши нужды для того, чтобы вывести на сайт станции необходимые данные — название и описание потока, количество слушателей, название текущего трека, фото исполнителя или аватар диджея.

Доступно две версии скрипта — PHP и Javascript. Рекомендуем использовать PHP-версию, однако, она может не работать на бесплатном хостинге (где расположен ваш сайт).

Для того, чтобы сгенерировать скрипт для сайта перейдите в раздел «Приложения» > «Конструктор скриптов».

Выберите услугу для создания скрипта, тип скрипта и пункты для отображения информации, после чего нажмите «Сгенерировать скрипт».

Откроется инструкция для добавления скрипта на сайт. Следуйте инструкции для подключения файлов скрипта.

Если у вас возникли трудности или ошибки при добавлении скрипта на свой сайт, создайте запрос в «Поддержке».

Для вывода списка загруженных треков на сайт, а также для их проигрывания и скачивания, существуют методы «Список файлов в автодиджее» и «Получение файла из автодиджея».

Метод «Список файлов в автодиджее» предназначен для получения списка файлов, которые загружены в автодиджей.

Метод «Получение файла из автодиджея» предназначен для получения на проигрывание или скачивание файла из автодиджея.

Заказ треков слушателями радиостанции осуществляется с сайта или публичной страницы (мини-сайта) станции. Для приема заявок следует настроить заказ треков и добавить соответствующий виджет на сайт. С помощью данного виджета слушатели вашей станции смогут выбирать треки из музыкальной базы и заказывать их. Заказанные треки попадают в очередь эфира.

О том как работает и настраивается прием заказов читайте в разделе «Заказ треков слушателями». Здесь же мы разберем виджеты, необходимые для того, чтобы осуществлять прием заказов с сайта.

Метод «Виджет заказа треков, с возможностью передачи сообщения» предназначен для вывода на сайт списка треков, доступных для заказа. Заказ треков настраивается в панели управления эфиром.

В виджете присутствует поиск по базе треков, а также есть возможность прикрепить сообщение при заказе трека (данную возможность можно выключить в настройках приема заказов).

Метод «Топ заказов автодиджея» предназначен для получения списка наиболее популярных треков, которые заказывают слушатели с вашего сайта, используя виджет заказа треков.

Существует несколько виджетов, предназначенных для вывода на сайт списков треков. Можно вывести на сайт последние проигранные треки (историю эфира), следующие треки (которые будут в эфире после текущего), а также новые (последние загруженные в панель) треки.

Метод «Список следующий треков» предназначен для получения списка следующих треков из автодиджея.

Данный метод не будет работать корректно при включенном режиме рандома. Читайте подробнее — «Режим рандома (проигрывание в случайном порядке)».

Метод «Список последних треков» предназначен для получения списка песен, которые недавно звучали в эфире.

Метод «Список новых треков» предназначен для получения списка новых треков из автодиджея. Сортировка производится по дате загрузке файлов в автодиджей.

Метод «Список новых треков» представляет собой комбинацию списка следующих и предыдущих треков.

Данный виджет также показывает трек, звучащий в данный момент (на основе виджета прошлых треков).

С помощью виджетов для вывода плейлистов можно отобразить на сайте название играющего в данный момент плейлиста, а также вывести расписание на основе запланированных плейлистов.

Метод «Список запланированных плейлистов (вывод расписания)» предназначен для получения списка запланированных плейлистов (расписания).

Метод «Название плейлиста в эфире» предназначен для получения названия плейлиста, который сейчас находится в эфире.

Метод «Виджет текущего времени на сервере» предназначен для получения текущего времени на сервере автодиджея во временной зоне автодиджея.

Часовой пояс, по которому работает станция, настраивается в настройках панели. Читайте подробнее — «Настройки панели».

Существует ограничение на 100 запросов в минуту с одного IP-адреса на один метод API. В случае превышения количества запросов появляется ошибка «Too many requests». Данное ограничение действует для всех версий панели и для всех пользователей.

Для Lite-версии панели отсутствуют дополнительные ограничения на количество запросов, однако, при сильной нагрузке, доступ к API может быть на время заблокирован.