Webhook
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.
Come funziona
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).
Verificare che un messaggio arrivi davvero da Samsa
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).
Buono a sapersi
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.