Les tâches d'image et de vidéo s'exécutent en arrière-plan. Plutôt que de vérifier sans cesse si une tâche est terminée, tu peux demander à Samsa de notifier ton app au moment où elle se termine. C'est à ça que servent les webhooks.
Quand tu lances une génération via l'API, tu peux inclure une URL de webhook — une adresse dans ta propre app. Dès que la tâche se termine, Samsa envoie un message à cette adresse avec le résultat, pour que ton app puisse réagir immédiatement. La façon exacte d'inclure l'URL de webhook est détaillée dans le guide des webhooks de la documentation développeur (s'ouvre dans un nouvel onglet).
Pour que tu puisses faire confiance aux notifications, Samsa signe chaque webhook et te fournit un secret de signature webhook pour vérifier cette signature.
Pour trouver ton secret :
Ouvre Paramètres de l'organisation > Clés API.
Repère le secret de signature webhook et choisis Afficher (ou Copier).
Garde ce secret privé, comme une clé API. Ton app l'utilise pour confirmer que chaque message entrant est authentique — la vérification pas à pas est dans le guide des webhooks (s'ouvre dans un nouvel onglet).
Les webhooks sont facultatifs — tu peux toujours vérifier l'état d'une tâche toi-même.
Si tu penses que ton secret de signature a été exposé, traite-le comme une clé : renouvelle-le et mets à jour ton app.
