Bild- und Video-Aufträge laufen im Hintergrund. Statt ständig zu prüfen, ob ein Auftrag fertig ist, kannst du Samsa deine App in dem Moment benachrichtigen lassen, in dem er fertig ist. Genau dafür sind Webhooks da.
Wenn du eine Generierung über die API startest, kannst du eine Webhook-URL angeben — eine Adresse in deiner eigenen App. Sobald der Auftrag fertig ist, sendet Samsa eine Nachricht an diese Adresse mit dem Ergebnis, sodass deine App sofort reagieren kann. Wie du die Webhook-URL genau angibst, steht im Webhooks-Guide in den Entwicklerdocs (öffnet in einem neuen Tab).
Damit du den Benachrichtigungen vertrauen kannst, signiert Samsa jeden Webhook und gibt dir ein Webhook-Signatur-Secret, mit dem du diese Signatur überprüfst.
So findest du dein Secret:
Öffne Organisationseinstellungen > API-Schlüssel.
Suche das Webhook-Signatur-Secret und wähle Anzeigen (oder Kopieren).
Halte dieses Secret geheim, genau wie einen API-Schlüssel. Deine App nutzt es, um zu bestätigen, dass jede eingehende Nachricht echt ist — die Schritt-für-Schritt-Überprüfung steht im Webhooks-Guide (öffnet in einem neuen Tab).
Webhooks sind optional — du kannst den Status eines Auftrags jederzeit auch selbst abfragen.
Wenn du glaubst, dass dein Signatur-Secret offengelegt wurde, behandle es wie einen Schlüssel: erneuere es und aktualisiere deine App.
