Passer au contenu principal
Utilisez webhooks pour être notifié lorsqu’un flux ou un actif change d’état, afin que votre application puisse mettre à jour l’interface utilisateur, commencer le traitement ou gérer les erreurs.

​
Événements d’actif

ÉvénementLorsqu’il se déclenche
asset.createdActif créé à la demande
asset.updatedActif mis à jour (par exemple, l’URL de lecture est disponible)
asset.readyActif prêt avec toutes les versions transcodées
asset.failedTéléchargement ou traitement en échec
asset.deletedActif supprimé
Configurez un point de terminaison de webhook, puis dans Développeurs → Webhookscréez un webhook avec votre URL et sélectionnez les événements d’actifs dont vous avez besoin. Voir Webhooks pour la vérification de signature et le format du chargement utile.

​
Événements de diffusion

ÉvénementQuand il se déclenche
stream.startedLe flux est actif ; l’URL HLS fonctionne
stream.idleLe flux n’est plus actif
recording.startedEnregistrement démarré sur le flux actif
recording.readyEnregistrement prêt à être téléchargé
recording.waitingFlux terminé avec enregistrement ; traitement (souvent ~5 min)
multistream.connectedConnecté à la cible multistream
multistream.errorErreur de connexion ou de diffusion vers la cible
multistream.disconnectedFin de la diffusion multistream vers la cible
Créez un webhook et sélectionnez les événements de diffusion, d’enregistrement ou de multistream. Votre point de terminaison reçoit le type d’événement et l’objet associé (diffusion, session, etc.) dans le corps du message.

​
Étapes de configuration

  1. Implémentez un point de terminaison POST qui retourne 2XX et vérifiez le Livepeer-Signature en-tête.
  2. Dans Studio, ajoutez l’URL du webhook et choisissez les événements.
  3. Gérez le event et event_object dans votre code (par exemple, mettre à jour la base de données, notifier l’utilisateur, réessayer en cas d’échec).
Voir Webhooks et Configurer et écouter les webhooks pour la configuration complète et la vérification de la signature.
Last modified on March 3, 2026