Webhooks in Video-Workflows: Ihre Pipeline automatisieren
Webhooks für die Videoautomatisierung: Funktionsweise, generische Payloads und Node.js-Beispiele. Klargestellt wird, dass das öffentliche dcast.tv-Creator-Dashboard keinen allgemeinen Webhook-Einstellungsablauf bietet – nutzen Sie die echte Anbieterdokumentation und Partner-API-Materialien.

On this page
Einführung in Webhooks
Mit Webhooks informiert ein System ein anderes, sobald etwas passiert, indem es eine HTTP-Anfrage an eine URL sendet, die Sie kontrollieren. Statt dass Ihre Anwendung ständig eine API abfragt und fragt „Ist das Video schon fertig?“, schickt der Anbieter im Moment des Ereignisses eine Nachricht. In Video-Workflows ist das das Rückgrat der Automatisierung: Abschluss des Transcodings, Ereignisse im Stream-Lebenszyklus, Verfügbarkeit von Aufzeichnungen und der Abschluss von Uploads können alle den nächsten Schritt Ihrer Pipeline auslösen, ohne dass jemand ein Dashboard beobachten muss.
Laden Sie Videos hoch, streamen und verkaufen Sie sie. Starten Sie mit dem kostenlosen Tarif – ohne Kreditkarte.
Kostenlos startenDie Mechanik ist einfach und bei allen Anbietern ähnlich. Der empfangende Server validiert die Anfrage (idealerweise durch Prüfung einer kryptografischen Signatur), antwortet schnell mit einem 2xx-Status und stellt aufwendige Arbeit zur Hintergrundverarbeitung in eine Warteschlange. Alles Weitere – Ereignisnamen, Payload-Strukturen, Wiederholungsverhalten – unterscheidet sich je nach Anbieter. Deshalb ist es wichtiger, das Muster zu verstehen, als sich die Felder eines einzelnen Anbieters einzuprägen.
Wo Webhook-URLs konfiguriert werden
Die Konfiguration ist immer anbieterspezifisch. Sie registrieren Ihren öffentlichen HTTPS-Endpunkt im Dashboard oder in der API genau dieses Anbieters – des Encoding-Dienstes, der Live-Plattform, des Zahlungsanbieters und so weiter. Der typische Ablauf: Callback-URL einfügen, die gewünschten Ereignistypen auswählen und ein ausgestelltes Signaturgeheimnis sicher speichern. Es gibt keine universelle „Webhook-Seite“, die alle Anbieter abdeckt; Sie folgen der Dokumentation des konkreten Produkts, das Sie tatsächlich integrieren, denn Ort und Terminologie unterscheiden sich jedes Mal.
DCAST und Produkte für Entwickler
Die öffentliche Creator-Oberfläche auf dcast.tv enthält keine allgemeine Einstellungsseite „Webhooks“, auf der Sie beliebige URLs für Ereignisse wie „Transcoding abgeschlossen“ oder „Stream gestartet“ hinzufügen können.
Partner- und API-Integrationen – die Dokumentation und Werkzeuge für Entwickler oder Pro-/Partner-Bereiche – sind der Ort, an dem Callbacks, signierte Ereignisse und verwandte Roadmap-Punkte hingehören; sie sind in der offiziellen Partner-API- und Entwicklerdokumentation beschrieben und nicht in einem fiktiven Ablauf in einem Endkunden-Dashboard. Im Zweifel vertrauen Sie der offiziellen Dokumentation mehr als einem Tutorial – auch diesem hier.
Typische Webhook-Ereignisse in Video-Workflows
Die genauen Bezeichnungen unterscheiden sich je nach Anbieter, aber die Ereigniskategorien sind branchenweit bemerkenswert einheitlich:
- Transcoding oder Encoding abgeschlossen – das Asset ist bereit für die Wiedergabe oder den nächsten Pipeline-Schritt (Vorschaubilder, Untertitel, Veröffentlichung).
- Stream gestartet / beendet – der Live-Lebenszyklus, nützlich für Analysen, Benachrichtigungen und das Auslösen der Aufzeichnung.
- Aufzeichnung bereit – die Wiederholungs- oder VOD-Version eines Livestreams ist jetzt verfügbar.
- Upload abgeschlossen – der Ingest ist beendet und die Rohdatei sicher gespeichert.
Eine gut gestaltete Pipeline verkettet diese Ereignisse: upload completed startet das Transcoding, transcoding finished löst die Erzeugung von Vorschaubildern aus und markiert das Asset als veröffentlichbar, und recording ready benachrichtigt Abonnenten, dass eine Wiederholung existiert. Jedes Ereignis erledigt genau eine Aufgabe und übergibt an das nächste.
Webhook-Payloads verstehen
Payloads sind fast immer JSON. Lesen Sie stets das tatsächliche Schema Ihres Anbieters, denn Feldnamen und Verschachtelung unterscheiden sich – das folgende Beispiel ist generisch und dient nur der Veranschaulichung:
{
"event": "transcoding_finished",
"video_id": "12345",
"status": "success",
"filename": "example_video.mp4",
"timestamp": "2023-10-05T12:00:00Z"
}
Zwei Gewohnheiten ersparen Ihnen echten Ärger. Erstens: Gehen Sie nie davon aus, dass ein Feld existiert – prüfen Sie defensiv, ob es vorhanden ist, bevor Sie es verwenden, denn Anbieter fügen Felder im Lauf der Zeit hinzu und benennen sie um. Zweitens: Behandeln Sie die Payload als Benachrichtigung, nicht als Quelle der Wahrheit. Bei allem Wichtigen rufen Sie mit der ID aus der Payload den maßgeblichen Datensatz über die API des Anbieters ab, statt dem Webhook-Body blind zu vertrauen, denn Payloads können gefälscht oder erneut eingespielt werden.
Webhooks mit Node.js verarbeiten
Einen einfachen Listener einrichten
const express = require('express');
const bodyParser = require('body-parser');
const app = express();
const port = 3000;
app.use(bodyParser.json());
app.post('/webhook', (req, res) => {
const payload = req.body;
console.log('Received webhook event: ' + payload.event);
res.status(200).send('Webhook received');
});
app.listen(port, () => {
console.log('Webhook server listening on port ' + port);
});
Beispiel: Nach Ereignistyp verzweigen
app.post('/webhook', (req, res) => {
const payload = req.body;
if (payload.event === 'transcoding_finished') {
console.log('Transcoding finished for video ' + payload.video_id);
}
res.status(200).send('Webhook received');
});
Signaturen verifizieren
Der wichtigste Sicherheitsschritt ist die Prüfung, ob eine Anfrage tatsächlich von Ihrem Anbieter stammt und nicht gefälscht wurde. Die meisten Anbieter signieren jede Anfrage mit einem HMAC des rohen Request-Body unter Verwendung Ihres gemeinsamen Geheimnisses und senden das Ergebnis in einem Header. Ihre Aufgabe ist es, diese Signatur neu zu berechnen und in konstanter Zeit zu vergleichen:
const crypto = require('crypto');
function verifySignature(rawBody, signatureHeader, secret) {
const expected = crypto
.createHmac('sha256', secret)
.update(rawBody)
.digest('hex');
// constant-time compare avoids leaking timing information
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signatureHeader)
);
}
Beachten Sie, dass die Signaturprüfung in der Regel den rohen Request-Body benötigt, genau so, wie er empfangen wurde. Hat Ihr JSON-Parser den Body bereits neu serialisiert, können die Bytes abweichen, und die Signatur stimmt nie überein – erfassen Sie den rohen Body daher vor dem Parsen, wenn ein Anbieter das verlangt.
Fehlerbehandlung und Wiederholungen
Implementieren Sie Idempotenz, indem Sie die ID jedes verarbeiteten Ereignisses speichern und Duplikate überspringen, denn Anbieter werden dasselbe Ereignis bei Netzwerkaussetzern mehr als einmal ausliefern. Geben Sie einen 2xx-Status erst zurück, nachdem Sie das Ereignis sicher angenommen haben – in der Regel nach dem Schreiben in eine dauerhafte Warteschlange, nicht nach Abschluss der eigentlichen Arbeit. Verarbeiten Sie langlaufende Aufgaben anschließend asynchron, damit beim Sender kein Timeout auftritt. Erledigen Sie aufwendige Arbeit direkt im Request und antworten zu langsam, geht der Anbieter von einem Fehler aus, wiederholt die Zustellung, und Sie verarbeiten dasselbe Ereignis immer wieder.
Best Practices
- Sicherheit: Verwenden Sie immer HTTPS, verifizieren Sie bei jeder Anfrage die Signatur und weisen Sie alles, was die Validierung nicht besteht, mit 401 oder 403 ab.
- Idempotenz: Gehen Sie von doppelten Zustellungen aus und deduplizieren Sie anhand der Ereignis-ID, damit eine erneute Zustellung nie doppelt abbucht, doppelt veröffentlicht oder doppelt benachrichtigt.
- Schnelle Bestätigung: Antworten Sie schnell mit einem 2xx und erledigen Sie die eigentliche Arbeit dann in einer Hintergrund-Warteschlange.
- Monitoring: Protokollieren Sie jede Zustellung und jeden Fehler, lösen Sie bei Anstiegen von Nicht-2xx-Antworten Alarm aus und führen Sie eine Dead-Letter-Queue für Ereignisse, die Sie nicht verarbeiten konnten.
Webhooks lokal testen
Da ein Webhook eine öffentlich erreichbare URL braucht, erfordert das Testen auf Ihrem Laptop einen Tunnel. Tools wie ngrok machen Ihren lokalen Server unter einer temporären öffentlichen HTTPS-Adresse verfügbar, sodass ein Anbieter während der Entwicklung http://localhost:3000 erreichen kann. Viele Anbieter bieten außerdem eine Schaltfläche „Testereignis senden“ und ein Zustellprotokoll, das jeden Versuch und den von Ihnen zurückgegebenen Antwortcode zeigt – nutzen Sie beides, um zu bestätigen, dass Ihr Endpunkt Signaturen validiert, schnell ein 2xx zurückgibt und die Payload korrekt verarbeitet, bevor Sie sich in der Produktion darauf verlassen.
Fazit
Webhooks sind ein bewährter, zuverlässiger Weg, Video-Pipelines zu automatisieren – aber nur, wenn die Plattform, die Sie nutzen, sie tatsächlich anbietet und Sie sie sicher und idempotent verarbeiten. Prüfen Sie das Verhalten anhand der aktuellen Produktdokumentation und verifizieren Sie bei jeder Anfrage die Signatur. Bauen Sie das Muster einmal richtig auf, und dieselbe Disziplin trägt über jeden Anbieter hinweg, den Sie je integrieren.
Nächste Schritte und Ressourcen
- Nutzen Sie die offizielle Dokumentation Ihres Encoding- oder Streaming-Anbieters für Ereignistypen, Payload-Format und Details zur Signaturprüfung.
- Verlassen Sie sich bei DCAST auf die veröffentlichten Partner-API-/Entwickler-Materialien, um den Integrationsumfang zu verstehen; gehen Sie nicht von einer Webhook-Oberfläche in einem Endkunden-Dashboard auf dcast.tv aus.
Häufig gestellte Fragen
Was sind Webhooks und wie funktionieren sie in Video-Workflows?
Webhooks sind HTTP-Callbacks, die ein Anbieter an eine von Ihnen kontrollierte URL sendet, wenn ein bestimmtes Ereignis eintritt. In Video-Workflows benachrichtigen sie Ihre Anwendung in Echtzeit über Dinge wie den Abschluss des Transcodings, Start und Ende eines Streams, den Abschluss von Uploads und die Verfügbarkeit von Aufzeichnungen – und lassen Sie den nächsten automatisierten Schritt auslösen, ohne abzufragen.
Wie richte ich Webhooks für einen Videoanbieter ein?
Der Ablauf ist immer anbieterspezifisch. Sie registrieren Ihren öffentlichen HTTPS-Endpunkt im Dashboard oder in der API dieses Anbieters, wählen die Ereignistypen aus, die Sie interessieren, und speichern das ausgestellte Signaturgeheimnis. Es gibt keinen universellen Ablauf, folgen Sie also der Dokumentation des genauen Produkts, das Sie integrieren. Für dcast.tv verlassen Sie sich speziell auf die offizielle Partner-API- und Entwicklerdokumentation, statt vorauszusetzen, dass es eine Webhook-Seite in einem Endkunden-Dashboard gibt.
Welche typischen Ereignisse lösen Webhooks in Video-Workflows aus?
Zu den gängigen Ereignissen gehören „Transcoding abgeschlossen“, „Stream gestartet“, „Stream beendet“, „Aufzeichnung bereit“ und „Upload abgeschlossen“. Die genauen Bezeichnungen unterscheiden sich je nach Anbieter, aber diese Kategorien decken die meisten Automatisierungsbedürfnisse ab.
Wie sichere und verifiziere ich Webhook-Payloads?
Stellen Sie Ihren Endpunkt über HTTPS bereit und verifizieren Sie die kryptografische Signatur, die der Anbieter mit jeder Anfrage sendet, mit Ihrem gemeinsamen Geheimnis und einem Vergleich in konstanter Zeit. Behandeln Sie die Payload als Benachrichtigung und nicht als Quelle der Wahrheit: Nutzen Sie die darin enthaltenen IDs, um den maßgeblichen Datensatz über die API des Anbieters abzurufen, bevor Sie eine folgenreiche Aktion ausführen.
Wie gehe ich mit doppelten oder fehlgeschlagenen Webhook-Zustellungen um?
Machen Sie Ihren Handler idempotent, indem Sie jede verarbeitete Ereignis-ID erfassen und Wiederholungen überspringen, denn Anbieter wiederholen die Zustellung bei jeder Nicht-2xx-Antwort oder jedem Timeout. Bestätigen Sie schnell mit einem 2xx, nachdem Sie das Ereignis sicher in eine Warteschlange gestellt haben, verarbeiten Sie die aufwendige Arbeit asynchron und führen Sie eine Dead-Letter-Queue samt Monitoring, damit fehlgeschlagene Zustellungen sichtbar und behebbar sind.
API-Dokumentation zu diesem Thema
dcast Team
Profis für Video-Streaming, die Creator zum Erfolg führen.
Ähnliche Artikel
Starten Sie noch heute Ihr Video-Business
Laden Sie Videos hoch, streamen und verkaufen Sie sie. Starten Sie mit dem kostenlosen Tarif – ohne Kreditkarte.
Kostenlos starten



