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

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

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

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

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

Параметр Тип Требование Описание
:shortname string Required Короткое имя канала (shortname) в пути запроса
date string Optional Дата расписания в формате YYYY-MM-DD (например, 2026-08-18)

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

Тест 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