Webhooks

Soyez notifié à la fin d'un job, sans poller.

Enregistrez une URL HTTPS avec POST /v1/webhooks. À la fin d'un job, Deklip envoie un POST JSON à votre serveur. Événements: job.completed, job.failed.

Exemple de charge utile

{
  "event": "job.completed",
  "jobId": "job_9f2c",
  "status": "done",
  "result": "https://s3.cultivatech.fr/deklip/results/job_9f2c.mp4",
  "createdAt": "2026-07-26T12:00:00Z"
}

Vérifier la signature

Chaque livraison porte l'en-tête X-Deklip-Signature: sha256=…, un HMAC-SHA256 du corps brut avec le secret renvoyé à la création du webhook. Recalculez-le et comparez avant de traiter.

// Node.js
import crypto from "node:crypto"
const sig = "sha256=" + crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex")
if (sig !== req.headers["x-deklip-signature"]) return res.status(401).end()