Plattform
Webhook
Ein Webhook ist ein signierter HTTP-Callback, den eine Plattform an deinen Server schickt, sobald ein asynchroner Job fertig ist – so musst du nicht ständig nachfragen. Videogenerierung, die Minuten dauert, ist der klassische Anwendungsfall.
Mit Signaturen kann der Empfänger prüfen, ob der Payload wirklich von der Plattform stammt.
Auf eroq
Events video.generation.succeeded / failed mit einem eroq-signature-Header im Stripe-Stil, konfiguriert im Entwickler-Dashboard.
Fragen
Muss ich Webhooks verwenden?
Nein – Polling über GET /v1/videos/generations/{id} funktioniert auch.
Welche Events sendet eroq?
video.generation.succeeded und video.generation.failed, dazu ein Test-Event, das du selbst im Dashboard auslöst. Bilder, Sprache und Chat antworten direkt auf die Anfrage, ein Rückruf ist dort also überflüssig.
Wie verifiziere ich einen eroq-Webhook?
Berechne die Signatur neu. Der Header eroq-signature enthält einen Zeitstempel und einen Hex-Digest – HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem unveränderten Request-Body, mit dem Endpoint-Secret als Schlüssel, das beim Erstellen einmalig angezeigt wurde.
Weitere Begriffe: Plattform