Каталог эфиров

Кто выходит в эфир — в одном открытом списке

Каталог источников эфиров: каналы и авторы в Telegram, которые выходят в эфир, серверы Owncast и PeerTube и трансляции, которые вещатели предлагают сами. Он подсказывает, куда смотреть, а не кто сейчас в эфире: приложение само опрашивает каждый источник.

Адрес

https://services.finchgram.com/live/v1/

Контракт (OpenAPI)Пояснения к контракту

API

Четыре эндпоинта

JSON только для чтения по HTTPS, без ключа и без cookie. Ответы содержат ETag, их можно хранить до пяти минут, а читать их может любая веб-страница.

GET/v1/directoryЧто это за каталог: его название, где его правила и сколько в нём источников
GET/v1/categoriesКатегории, к которым отнесены источники каталога, с названиями на каждом языке
GET/v1/sourcesИсточники с фильтрацией по типу, категории, языку, стране или ключевым словам
GET/v1/sources/{id}Один источник

В каталоге

Источники0

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

Каталог изначально пуст: каждый источник попадает в него через pull request.

Добавить первый

Внести вклад

Добавить источник

Источник — это один файл, data/live/sources/<id>.json, добавленный через pull request. Автоматическая проверка сверяет его с контрактом, а после слияния каталог отдаёт его со следующего развёртывания.

Как добавить источник

Каким должен быть каждый источник

Место, которое его владелец сделал публичным: имя пользователя в Telegram, сервер Owncast, канал PeerTube
Трансляция по HLS — только от самого вещателя или с его разрешения
Ничего, что требует для воспроизведения ключа, входа в аккаунт или заголовков другого приложения
Контент для взрослых — с соответствующей пометкой

Самостоятельный хостинг

Запустите свой каталог

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

Исходный код