Skip to main content

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.).

Configurer un webhook

Réponse :

Événements disponibles


Format du payload

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.