Qu’est-ce qu’un webhook ?
Plutôt que de poller /tasks/:id toutes les N secondes, vous configurez une URL sur votre serveur. DLoopIQ envoie une requête HTTP POST dès qu’un événement se produit (tâche validée, tâche échouée, etc.).
Réponse :
Événements disponibles
task.completed
task.failed
Vérifier la signature
Chaque requête webhook inclut un header x-dloopiq-signature avec un HMAC-SHA256 calculé sur le corps de la requête.
Voir le guide complet → Vérification des signatures
Gérer les webhooks
Lister vos webhooks
Mettre à jour
Supprimer
Réponse attendue
Votre endpoint doit répondre avec un HTTP 2xx dans les 10 secondes. En cas d’échec (timeout ou 5xx), DLoopIQ effectue 1 retry après 30 secondes.
Traitez le webhook de manière asynchrone — répondez 200 immédiatement, puis traitez en arrière-plan. Un traitement > 10s entraîne un retry et des doublons.