Medienaufträge laufen im Hintergrund und können je nach Datei Sekunden oder auch eine Stunde dauern. Damit deine Software nicht ständig nachfragen muss, schickt FlowData eine Rückmeldung an deinen Server, sobald ein Auftrag fertig oder fehlgeschlagen ist. Dafür richtest du einen Webhook-Endpunkt ein.
Endpunkt anlegen
- Öffne links unter Medienverarbeitung den Punkt Webhooks.
- Klicke auf Endpunkt anlegen.
- Trage die URL deines Servers ein. Sie muss mit
https://beginnen und öffentlich erreichbar sein. - Optional: Gib unter Beschreibung (optional) an, wofür der Endpunkt gedacht ist.
- Wähle die Ereignisse:
job.finishedfür fertige undjob.failedfür fehlgeschlagene Aufträge. - Setze bei Bedarf den Haken bei Standard-Endpunkt. Mehr dazu unten.
- Klicke auf Speichern.
Direkt danach zeigt FlowData das Signaturgeheimnis an. Es beginnt mit whsec_. Kopiere es sofort und hinterlege es auf deinem Server, es wird nur dieses eine Mal angezeigt. Bestätige mit Ich habe das Geheimnis gespeichert.
Die Liste der Endpunkte
Je Endpunkt siehst du die URL mit Beschreibung und ID, die abonnierten Ereignisse, den Status (Aktiv oder Inaktiv, dazu die Markierung Standard) und das Ergebnis vom Letzter Test.

Rechts in jeder Zeile stehen die Aktionen:
- Testzustellung senden: schickt eine Test-Rückmeldung mit dem Ereignis
webhook.testan deinen Server. So prüfst du, ob er erreichbar ist und antwortet. - Bearbeiten: URL, Beschreibung, Ereignisse und Standard ändern. Hier kannst du einen Endpunkt auch über Aktiv pausieren. Inaktive Endpunkte erhalten keine Rückmeldungen und können nicht in neuen Aufträgen verwendet werden.
- Geheimnis erneuern: erzeugt ein neues Signaturgeheimnis. Das bisherige signiert noch 24 Stunden mit, so kannst du deinen Server ohne Ausfall umstellen.
- Löschen: entfernt den Endpunkt. Offene Zustellungen an ihn werden aufgegeben.
Endpunkte lassen sich auch über die API unter https://api.flowdata.one/v1/media/webhook-endpoints auflisten, anlegen und löschen.
Endpunkt im Auftrag verwenden
Gib im Auftrag die ID des Endpunkts an, die unter der URL in der Liste steht:
"callback": { "endpoint_id": "DEINE_ENDPUNKT_ID" }
Alternativ kannst du eine freie Adresse mit "callback": { "url": "https://…" } angeben. Solche Rückmeldungen signiert FlowData mit dem Geheimnis des Standard-Endpunkts. Gibt es keinen Standard-Endpunkt, gehen sie unsigniert raus. Je Team gibt es höchstens einen Standard-Endpunkt.
Rückmeldungen prüfen
Jede Rückmeldung ist nach dem offenen Standard „Standard Webhooks“ signiert und enthält die Header webhook-id, webhook-timestamp und webhook-signature. Der Body enthält das Ereignis, den Auftrag mit allen Ausgaben und deine Metadaten. Gängige Standard-Webhooks-Bibliotheken prüfen die Signatur ohne eigenen Code. Das genaue Verfahren mit Beispiel steht in der API-Dokumentation zur Medienverarbeitung.
Dein Server sollte:
- die Signatur gegen den unveränderten Body prüfen und Zeitstempel verwerfen, die mehr als fünf Minuten abweichen
- innerhalb von zehn Sekunden mit einem Status 2xx antworten, Weiterleitungen werden nicht verfolgt
- bereits verarbeitete
webhook-idüberspringen, denn bei Wiederholungen bleibt sie gleich
Wenn eine Zustellung fehlschlägt
Antwortet dein Server nicht rechtzeitig oder mit einem Fehler, wiederholt FlowData die Zustellung bis zu sieben Mal mit wachsenden Abständen von 30 Sekunden bis zu 6 Stunden. In der Detailansicht eines Auftrags siehst du unter Webhook-Zustellungen den Status jeder Rückmeldung:
- Ausstehend: die Zustellung ist noch unterwegs
- Zugestellt: dein Server hat sie angenommen
- Wird wiederholt: der letzte Versuch ist gescheitert, der Nächster Versuch steht daneben
- Aufgegeben: alle Versuche sind gescheitert
Ist dein Server wieder erreichbar, klickst du auf das Pfeil-Symbol Erneut senden, um die Zustellung sofort neu anzustoßen. Mehr zur Detailansicht in Wie verfolge ich den Status meiner Medienaufträge?.