Qui passe en direct, dans une liste ouverte
Un annuaire de sources en direct : des chaînes et des créateurs Telegram qui passent en direct, des serveurs Owncast et PeerTube, et des flux que les diffuseurs proposent eux-mêmes. Il indique où regarder, pas qui est en direct en ce moment : une application le demande elle-même à chaque source.
Quatre points de terminaison
Du JSON en lecture seule via HTTPS, sans clé ni cookies. Les réponses comportent un ETag et peuvent être mises en cache pendant cinq minutes, et toute page web peut les lire.
GET/v1/directoryCe qu'est l'annuaire : son nom, où se trouvent ses règles et combien de sources il répertorieGET/v1/categoriesLes catégories dans lesquelles ses sources sont classées, nommées dans chaque langueGET/v1/sourcesLes sources, filtrées par type, catégorie, langue, pays ou mots-clésGET/v1/sources/{id}Une source
Sources0
Aucune source pour l'instant
L'annuaire est vide au départ : chaque source y entre par une pull request.
Ajouter la premièreAjouter une source
Une source est un seul fichier, data/live/sources/<id>.json, ajouté par une pull request. Une vérification s'assure qu'il respecte le contrat d'API, et une fois la pull request fusionnée, l'annuaire le sert dès le déploiement suivant.
Ce que doit être chaque source
- Un lieu que son propriétaire a rendu public : un nom d'utilisateur Telegram, un serveur Owncast, une chaîne PeerTube
- Un flux HLS uniquement de la part de son diffuseur, ou avec son autorisation
- Rien qui exige une clé, un identifiant ou les en-têtes d'une autre application pour être lu
- Du contenu pour adultes, marqué comme tel
Hébergez votre propre annuaire
Forkez le dépôt et déployez-le sur Cloudflare Workers sous votre propre domaine, ou servez le même JSON depuis le serveur de votre choix. Un annuaire est une liste que chacun peut tenir : une application qui en lit un les lit tous.
Code source