Saltar al contenido principal
Webhooksdeje que Livepeer Studio envíe solicitudes HTTP POST a su punto de conexión cuando ocurran eventos. Puede reaccionar a los cambios de estado de la transmisión/activo, grabaciones, estado de multitransmisión y verificaciones de control de acceso.

​
Tipos de evento

EventoDescripción
Transmisiónstream.started, stream.idle
Grabaciónrecording.started, recording.ready, recording.waiting
Multistreammultistream.connected, multistream.error, multistream.disconnected
Activoasset.created, asset.updated, asset.ready, asset.failed, asset.deleted
Tareatask.spawned, task.updated, task.completed, task.failed
Control de accesoplayback.accessControl (para reproducción restringida; su punto de conexión permite o deniega)

​
Configura un webhook

  1. Crea un punto de conexión HTTP en tu aplicación que acepte POST y devuelva 2XX rápidamente (procese de forma asíncrona si es necesario).
  2. Regístrese en Studio — Desarrolladores → Webhooks, haz clic en Crear, ingresa tu URL y selecciona los eventos que desees.
  3. Verificar firmas — Cada solicitud incluye unLivepeer-Signature encabezado (marca de tiempo y HMAC). Verifícalo usando tu secreto de webhook para evitar aceptar eventos falsificados. Consulta Livepeer Studio docs para el esquema de firma.
Los campos de carga suelen incluir webhookId, timestamp, event, y event_object (el flujo, activo o tarea). Use timestamp en la verificación de firma para protegerse contra repeticiones.

​
Desarrollo local

Use un túnel (por ejemplo: ngrok) para exponer su servidor local y usar esa URL como punto de conexión de webhook. Para producción, implemente su servidor en una URL pública. Vea Escuchar eventos para el uso de eventos de activo/transmisión y Control de acceso con webhooks para reproducción restringida.
Last modified on March 1, 2026