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.

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 ; sync = un signal sync.wakeup vous invitant à venir chercher les données.

Allowed:
Responses

403

Signature clé de site invalide ou périmée, ou compte sans droit sur ce site.

404

Site inconnu.

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