I job di immagini e video vengono eseguiti in background. Invece di controllare di continuo se un job è finito, puoi far sì che Samsa avvisi la tua app nel momento in cui finisce. È a questo che servono i webhook.
Quando avvii una generazione tramite l'API, puoi includere un URL webhook — un indirizzo nella tua app. Non appena il job finisce, Samsa invia un messaggio a quell'indirizzo con il risultato, così la tua app può reagire subito. Come includere esattamente l'URL webhook è spiegato nella guida ai webhook della documentazione per sviluppatori (si apre in una nuova scheda).
Perché tu possa fidarti delle notifiche, Samsa firma ogni webhook e ti fornisce un secret di firma webhook per verificare quella firma.
Per trovare il tuo secret:
Apri Impostazioni organizzazione > Chiavi API.
Individua il secret di firma webhook e scegli Mostra (o Copia).
Tieni questo secret privato, proprio come una chiave API. La tua app lo usa per confermare che ogni messaggio in arrivo è autentico — la verifica passo passo è nella guida ai webhook (si apre in una nuova scheda).
I webhook sono facoltativi — puoi sempre controllare tu stesso lo stato di un job.
Se pensi che il tuo secret di firma sia stato esposto, trattalo come una chiave: rigeneralo e aggiorna la tua app.
