Crée ou remplace la configuration webhook du site. L'URL cible doit
être en HTTPS et pointer vers un hôte public.
⚠ Chaque appel régénère le secret de signature (la configuration
précédente est entièrement remplacée) : récupérez-le dans la réponse,
il signe toutes les livraisons à venir.
Deux authentifications possibles : signature « clé de site » en
?key= (serveur-à-serveur), ou JWT d'un compte propriétaire/
administrateur.
⚠ Sans ?key= et sans JWT valide, la réponse est HTTP 200 avec
un corps {"gcCode": 410, "msg": "route need authentication"} — le
webhook n'est alors pas configuré. Vérifiez l'absence du champ
gcCode avant de considérer la configuration comme enregistrée.
⚠ Les noms d'événements ne sont pas validés côté serveur : une
faute de frappe est acceptée (200, active: true) mais l'événement
mal orthographié ne recevra jamais aucune livraison. Copiez
exactement les types listés ci-dessous.
Offre Enterprise : le mode events (une livraison par événement,
mode par défaut) est réservé à l'offre Enterprise. Hors Enterprise,
l'appel répond 403 avec code: "WEBHOOK_EVENTS_ENTERPRISE_ONLY", y
compris quand mode est omis, et la configuration existante n'est pas
modifiée. Le mode sync est ouvert à toutes les offres. Si le site
quitte l'offre Enterprise, les livraisons events cessent (la
configuration est conservée, les événements de la période ne sont pas
rattrapés).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
404Site inconnu — appel avec un compte seulement (jamais avec une clé de site).
500Erreur serveur ({"error":"Erreur serveur"}).
