Dexyd DevelopersAPI, webhooks et assistants IA
Webhooks Dexyd

Recevez les moments importants sans surveiller Dexyd en continu.

Les webhooks préviennent vos outils lorsqu’une action utile se produit dans Dexyd : évolution d’un concours, nouvelle soumission, demande Expo, signal commercial ou étape à suivre.

AlertesAlertes au bon moment.
RéactionRéaction plus rapide.
SuiviMoins de vérification manuelle.

Concours

Suivez les étapes clés dès qu’elles avancent.

Participations

Repérez les nouvelles soumissions plus vite.

Expo

Faites remonter les demandes commerciales au bon endroit.

Configuration

Créer et tester un webhook

Un webhook associe une URL HTTPS, une liste d’événements et un secret de signature généré par Dexyd.

Console
/developer

Création, test, désactivation et consultation des livraisons.

GET /api/developer/webhooks
Lister les webhooks du compte connecté.
POST /api/developer/webhooks
Créer une destination et recevoir le secret complet une seule fois.
PATCH /api/developer/webhooks/{id}
Modifier l’URL, les événements ou le statut.
DELETE /api/developer/webhooks/{id}
Révoquer une destination.
POST /api/developer/webhooks/{id}/test
Envoyer test.ping vers l’URL configurée.
Événements

Événements actuellement émis

Abonnez uniquement les flux dont votre outil a besoin pour éviter les traitements inutiles.

competition.created
Un concours est créé.
competition.updated
Un concours est modifié.
submission.created
Une participation est déposée.
submission.updated
Une participation change de statut ou de contenu.
expo_product.created
Un produit Expo est publié ou préparé.
expo_product.updated
Un produit Expo est modifié.
expo_product.bid.created
Une enchère Expo est enregistrée.
expo_product.inquiry.created
Une demande commerciale Expo est créée.
test.ping
Événement de vérification envoyé depuis la console.
Livraison

Payload, signature et vérification

Dexyd signe chaque POST sortant pour que votre serveur puisse vérifier l’origine et rejeter les rejeux.

Payload
{
  "id": "delivery_...",
  "event": "submission.created",
  "created_at": "2026-06-11T12:00:00.000Z",
  "data": {
    "competition_id": "...",
    "submission_id": "..."
  }
}
Headers
X-Dexyd-Event: submission.created
X-Dexyd-Delivery: delivery_...
X-Dexyd-Timestamp: 1781179200
X-Dexyd-Signature: t=1781179200,v1=<hmac_sha256>
  • La signature v1 est calculée en HMAC SHA-256 sur timestamp.body avec le secret whsec.
  • Dexyd attend la réponse de votre endpoint pendant 8 secondes et journalise le statut, le code HTTP et un extrait de réponse.
Erreurs

États à gérer côté destination

Votre endpoint doit répondre vite, vérifier la signature et accepter les événements de manière idempotente.

2xx
Livraison marquée delivered.
4xx / 5xx
Livraison marquée failed avec le code de réponse.
Timeout ou réseau
Livraison marquée failed avec le message d’erreur.
Secret perdu
Créez une nouvelle destination ou effectuez une rotation depuis la console.