Документация API для сторонних приложений

Публичный API для разработчиков

Добро пожаловать в центр документации разработчиков платформы ЭтоЯTV! Здесь собраны API эндпоинты, которые позволят вам создавать ботов, внешние виджеты, плееры, мобильные приложения или собственные сервисы интеграции на базе нашей платформы.

🔒 Важная информация о безопасности

Все описанные ниже API-методы являются публичными и доступны исключительно для чтения (Read-Only). Доступ к админ-панели канала, панели управления трансляциями, ключам вещания (Stream Key) и паролям через эти методы полностью исключен. Авторизация или регистрация для выполнения запросов не требуются.
Базовый URL для запросов:
https://etoyatv.motionlmao.top

Глобальная статистика платформы

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

GET
/api/public/stats

Интерактивная песочница

⚡ Тест GET /api/public/stats

Список телеканалов

Возвращает постраничный список всех активных публичных каналов платформы с их текущим статусом вещания и ссылками на медиа-ресурсы.

GET
/api/public/channels

Query параметры

Параметр Тип Требование Описание
q string Optional Поисковый запрос по названию или короткому имени канала (shortname)
live string Optional Фильтр по эфиру: 1 - только онлайн, 0 - только оффлайн
limit integer Optional Лимит результатов (от 1 до 100, по умолчанию 20)
offset integer Optional Смещение для пагинации (по умолчанию 0)

Интерактивная песочница

⚡ Тест GET /api/public/channels

Детали конкретного телеканала

Возвращает профиль и подробные характеристики одного указанного канала по его короткому названию (shortname).

GET
/api/public/channels/:shortname

Параметры пути

Параметр Тип Описание
:shortname string Короткое имя канала из URL (например, rvota_tv_official)

Интерактивная песочница

⚡ Тест GET /api/public/channels/{shortname}

Эфирные стримы

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

GET
/api/public/streams

Интерактивная песочница

⚡ Тест GET /api/public/streams

Программа передач (Расписание)

Возвращает расписание телепередач канала на сегодня или на выбранную дату.

GET
/api/public/channels/:shortname/schedule

Query параметры

Параметр Тип Требование Описание
date string Optional Конкретная дата в формате YYYY-MM-DD. Если не передано, возвращает текущие и будущие программы.

Интерактивная песочница

⚡ Тест GET /api/public/channels/{shortname}/schedule

Новости телеканала

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

GET
/api/public/channels/:shortname/news

Интерактивная песочница

⚡ Тест GET /api/public/channels/{shortname}/news

Записи прошедших эфиров

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

GET
/api/public/channels/:shortname/records

Интерактивная песочница

⚡ Тест GET /api/public/channels/{shortname}/records