Passer au contenu principal
Webhooks faites envoyer par Livepeer Studio des requêtes HTTP POST à votre point de terminaison lorsqu’un événement se produit. Vous pouvez réagir aux changements d’état de diffusion/actif, aux enregistrements, au statut multistream et aux vérifications d’accès.

Types d’événements

ÉvénementDescription
Diffusionstream.started, stream.idle
Enregistrementrecording.started, recording.ready, recording.waiting
Multistreammultistream.connected, multistream.error, multistream.disconnected
Actifasset.created, asset.updated, asset.ready, asset.failed, asset.deleted
Tâchetask.spawned, task.updated, task.completed, task.failed
Contrôle d’accèsplayback.accessControl (pour la lecture restreinte ; votre point de terminaison autorise ou refuse)

Configurer un webhook

  1. Créer un point de terminaison HTTP dans votre application qui accepte les POST et retourne rapidement un 2XX (traitez en asynchrone si nécessaire).
  2. Enregistrer dans StudioDéveloppeurs → Webhooks, cliquez sur Créer, entrez votre URL et sélectionnez les événements que vous souhaitez.
  3. Vérifier les signatures — Chaque requête inclut un Livepeer-Signature en-tête (horodatage et HMAC). Vérifiez-le à l’aide de votre secret de webhook pour éviter d’accepter des événements falsifiés. Voir Livepeer Docs Studio pour le schéma de signature.
Les champs de charge utile comprennent généralement webhookId, timestamp, event, et event_object (le flux, l’actif ou la tâche). Utilisez timestamp lors de la vérification de la signature pour se prémunir contre les rejeux.

Développement local

Utilisez un tunnel (par exemple ngrok) pour exposer votre serveur local et utiliser cette URL comme point de terminaison webhook. Pour la production, déployez votre serveur sur une URL publique. Voir Écouter les événements pour l’utilisation d’événements d’actif/flux et Contrôle d’accès avec des webhooks pour la lecture restreinte.
Last modified on March 1, 2026