Une API pensée pour une intégration en une journée

Trois appels, côté serveur

1. 01

   Créer l’envoi

   Votre serveur crée la vidéo et renvoie l’URL d’envoi au navigateur du formateur, qui y dépose le fichier directement.

   import { Vidoum } from "@vidoum/node";
   const vidoum = new Vidoum({ apiKey: process.env.VIDOUM_API_KEY });
   
   const { video, upload } = await vidoum.uploads.create({
     title: "Séance 3 — La cellule",
     contentType: "video/mp4",
     size: file.size,
     externalRef: "lesson:42",
   });
   // → upload.url : le navigateur y envoie le fichier (PUT)

2. 02

   Être prévenu

   Quand l’encodage est terminé, Vidoum appelle votre webhook. Vérifiez la signature avant de publier la leçon.

   const event = await Vidoum.verifyWebhook(
     rawBody,
     request.headers.get("Vidoum-Signature"),
     process.env.VIDOUM_WEBHOOK_SECRET,
   );
   if (event.type === "video.ready") {
     await publishLesson(event.data.video.externalRef);
   }

3. 03

   Diffuser

   Après avoir vérifié que l’apprenant a accès au cours, demandez un lien personnel et affichez le lecteur.

   const { embedUrl } = await vidoum.playback.createToken({
     videoId: lesson.videoId,
     viewer: user.email, // affiché en filigrane
   });
   
   // <iframe src={embedUrl}
   //   allow="autoplay; fullscreen; picture-in-picture"
   //   allowfullscreen></iframe>