Configurer le webhook d'un site

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[a-f0-9]{24}$

Identifiant interne du site (24 caractères hexadécimaux) — ⚠ le shortname n'est PAS accepté sur les routes webhook.

Body Params
uri
required

URL de réception (HTTPS obligatoire, hôte public).

events
array of strings
required
length ≥ 1

Événements souscrits : comment.created, comment.updated, comment.deleted, comment.approved, ou * pour tout recevoir.

events*
string
enum
Defaults to events

events = une livraison par événement (offre Enterprise uniquement, mode par défaut) ; sync = un signal sync.wakeup vous invitant à venir chercher les données (toutes les offres). La valeur est lue sans tenir compte de la casse ni des espaces autour.

Allowed:
Responses

404

Site inconnu — appel avec un compte seulement (jamais avec une clé de site).

500

Erreur serveur ({"error":"Erreur serveur"}).

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json