Développeurs

Construire avec Bluvy Tube

Bluvy Tube est un client vidéo du réseau AT Protocol, et tout ce qu’il publie est ouvert. Vous pouvez intégrer son lecteur, lire ses enregistrements et relier vos apps aux siennes, sans clé d’API ni inscription.

Bluvy Tube et le protocole

Les vidéos et les données de Bluvy Tube ne vivent pas sur nos serveurs : elles sont dans le dépôt (PDS) de chaque utilisateur. Bluvy Tube les indexe et les met en forme, à la manière d’une AppView. Concrètement :

Pas de clé d’API. Le lecteur, oEmbed et les endpoints décrits ici sont publics. Le reste des données se lit directement sur le réseau.
Chaque vidéo est un post app.bsky.feed.post standard, accompagné d’un enregistrement app.bluvy.tube.video.metadata (titre, description, chapitres, sous-titres…). Les playlists, les favoris et les préférences sont aussi des enregistrements app.bluvy.tube.*.
Les fichiers vidéo sont servis en HLS par le CDN vidéo de Bluesky (video.bsky.app).

Guides

Lecteur & embed Intégrer le lecteur dans une page et le piloter par postMessage. Aussi : oEmbed, sous-titres et chapitres, liens profonds. Données publiques Lexicons app.bluvy.tube.*, lecture des enregistrements et du firehose, médias, endpoints HTTP et limites.

Identité de l’app

Bluvy Tube a sa propre identité sur le réseau. Ses lexicons sont publiés depuis ce compte, et chaque page du site la déclare dans ses at-tags.

DID	`did:plc:dgqudubx2plnmynqu5wtsoan`
Handle	`@tube.bluvy.app`
Vérification du handle	`https://tube.bluvy.app/.well-known/atproto-did`
Lexicons	`app.bluvy.tube.*` — Données publiques
at-tags	`<meta name="at:me" content="at://did:plc:dgqudubx2plnmynqu5wtsoan">`

Bonnes pratiques

Pour les données, préférez la source (PDS, Jetstream, relais) à nos pages : c’est plus complet, et vous ne dépendez pas de nous.
Mettez en cache. Les réponses oEmbed indiquent cache_age, et les embeds envoient un Cache-Control.
Identifiez vos requêtes automatisées avec un User-Agent explicite (nom de l’app et URL de contact).
Seuls les endpoints marqués « stables » sont garantis. Les autres peuvent changer sans préavis.

Une question, un besoin, un bug ? Écrivez-nous.